/*

 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.

 *

 * This code is free software; you can redistribute it and/or modify it

 * under the terms of the GNU General Public License version 2 only, as

 * published by the Free Software Foundation.  Oracle designates this

 * particular file as subject to the "Classpath" exception as provided

 * by Oracle in the LICENSE file that accompanied this code.

 *

 * This code is distributed in the hope that it will be useful, but WITHOUT

 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or

 * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License

 * version 2 for more details (a copy is included in the LICENSE file that

 * accompanied this code).

 *

 * You should have received a copy of the GNU General Public License version

 * 2 along with this work; if not, write to the Free Software Foundation,

 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.

 *

 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA

 * or visit www.oracle.com if you need additional information or have any

 * questions.

 */

/*

 * This file is available under and governed by the GNU General Public

 * License version 2 only, as published by the Free Software Foundation.

 * However, the following notice accompanied the original version of this

 * file and, per its terms, should not be removed:

 *

 * Copyright (c) 2000 World Wide Web Consortium,

 * (Massachusetts Institute of Technology, Institut National de

 * Recherche en Informatique et en Automatique, Keio University). All

 * Rights Reserved. This program is distributed under the W3C's Software

 * Intellectual Property License. This program is distributed in the

 * hope that it will be useful, but WITHOUT ANY WARRANTY; without even

 * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR

 * PURPOSE.

 * See W3C License http://www.w3.org/Consortium/Legal/ for more details.

 */

package org.w3c.dom.css;

import org.w3c.dom.DOMException;

/**

 *  The <code>CSS2Properties</code> interface represents a convenience

 * mechanism for retrieving and setting properties within a

 * <code>CSSStyleDeclaration</code>. The attributes of this interface

 * correspond to all the properties specified in CSS2. Getting an attribute

 * of this interface is equivalent to calling the

 * <code>getPropertyValue</code> method of the

 * <code>CSSStyleDeclaration</code> interface. Setting an attribute of this

 * interface is equivalent to calling the <code>setProperty</code> method of

 * the <code>CSSStyleDeclaration</code> interface.

 * <p> A conformant implementation of the CSS module is not required to

 * implement the <code>CSS2Properties</code> interface. If an implementation

 * does implement this interface, the expectation is that language-specific

 * methods can be used to cast from an instance of the

 * <code>CSSStyleDeclaration</code> interface to the

 * <code>CSS2Properties</code> interface.

 * <p> If an implementation does implement this interface, it is expected to

 * understand the specific syntax of the shorthand properties, and apply

 * their semantics; when the <code>margin</code> property is set, for

 * example, the <code>marginTop</code>, <code>marginRight</code>,

 * <code>marginBottom</code> and <code>marginLeft</code> properties are

 * actually being set by the underlying implementation.

 * <p> When dealing with CSS "shorthand" properties, the shorthand properties

 * should be decomposed into their component longhand properties as

 * appropriate, and when querying for their value, the form returned should

 * be the shortest form exactly equivalent to the declarations made in the

 * ruleset. However, if there is no shorthand declaration that could be

 * added to the ruleset without changing in any way the rules already

 * declared in the ruleset (i.e., by adding longhand rules that were

 * previously not declared in the ruleset), then the empty string should be

 * returned for the shorthand property.

 * <p> For example, querying for the <code>font</code> property should not

 * return "normal normal normal 14pt/normal Arial, sans-serif", when "14pt

 * Arial, sans-serif" suffices. (The normals are initial values, and are

 * implied by use of the longhand property.)

 * <p> If the values for all the longhand properties that compose a particular

 * string are the initial values, then a string consisting of all the

 * initial values should be returned (e.g. a <code>border-width</code> value

 * of "medium" should be returned as such, not as "").

 * <p> For some shorthand properties that take missing values from other

 * sides, such as the <code>margin</code>, <code>padding</code>, and

 * <code>border-[width|style|color]</code> properties, the minimum number of

 * sides possible should be used; i.e., "0px 10px" will be returned instead

 * of "0px 10px 0px 10px".

 * <p> If the value of a shorthand property can not be decomposed into its

 * component longhand properties, as is the case for the <code>font</code>

 * property with a value of "menu", querying for the values of the component

 * longhand properties should return the empty string.

 * <p>See also the <a href='http://www.w3.org/TR/2000/REC-DOM-Level-2-Style-20001113'>Document Object Model (DOM) Level 2 Style Specification</a>.

 * @since DOM Level 2

 */

public interface CSS2Properties {

    /**

     *  See the azimuth property definition in CSS2.

     */

    public String getAzimuth();

    /**

     *  See the azimuth property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */

    public void setAzimuth(String azimuth)

                                             throws DOMException;

    /**

     *  See the background property definition in CSS2.

     */

    public String getBackground();

    /**

     *  See the background property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */

    public void setBackground(String background)

                                             throws DOMException;

    /**

     *  See the background-attachment property definition in CSS2.

     */

    public String getBackgroundAttachment();

    /**

     *  See the background-attachment property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */

    public void setBackgroundAttachment(String backgroundAttachment)

                                             throws DOMException;

    /**

     *  See the background-color property definition in CSS2.

     */

    public String getBackgroundColor();

    /**

     *  See the background-color property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */

    public void setBackgroundColor(String backgroundColor)

                                             throws DOMException;

    /**

     *  See the background-image property definition in CSS2.

     */

    public String getBackgroundImage();

    /**

     *  See the background-image property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */

    public void setBackgroundImage(String backgroundImage)

                                             throws DOMException;

    /**

     *  See the background-position property definition in CSS2.

     */

    public String getBackgroundPosition();

    /**

     *  See the background-position property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */

    public void setBackgroundPosition(String backgroundPosition)

                                             throws DOMException;

    /**

     *  See the background-repeat property definition in CSS2.

     */

    public String getBackgroundRepeat();

    /**

     *  See the background-repeat property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */

    public void setBackgroundRepeat(String backgroundRepeat)

                                             throws DOMException;

    /**

     *  See the border property definition in CSS2.

     */

    public String getBorder();

    /**

     *  See the border property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */

    public void setBorder(String border)

                                             throws DOMException;

    /**

     *  See the border-collapse property definition in CSS2.

     */

    public String getBorderCollapse();

    /**

     *  See the border-collapse property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */

    public void setBorderCollapse(String borderCollapse)

                                             throws DOMException;

    /**

     *  See the border-color property definition in CSS2.

     */

    public String getBorderColor();

    /**

     *  See the border-color property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */

    public void setBorderColor(String borderColor)

                                             throws DOMException;

    /**

     *  See the border-spacing property definition in CSS2.

     */

    public String getBorderSpacing();

    /**

     *  See the border-spacing property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */

    public void setBorderSpacing(String borderSpacing)

                                             throws DOMException;

    /**

     *  See the border-style property definition in CSS2.

     */

    public String getBorderStyle();

    /**

     *  See the border-style property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */

    public void setBorderStyle(String borderStyle)

                                             throws DOMException;

    /**

     *  See the border-top property definition in CSS2.

     */

    public String getBorderTop();

    /**

     *  See the border-top property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */

    public void setBorderTop(String borderTop)

                                             throws DOMException;

    /**

     *  See the border-right property definition in CSS2.

     */

    public String getBorderRight();

    /**

     *  See the border-right property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */

    public void setBorderRight(String borderRight)

                                             throws DOMException;

    /**

     *  See the border-bottom property definition in CSS2.

     */

    public String getBorderBottom();

    /**

     *  See the border-bottom property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */

    public void setBorderBottom(String borderBottom)

                                             throws DOMException;

    /**

     *  See the border-left property definition in CSS2.

     */

    public String getBorderLeft();

    /**

     *  See the border-left property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */

    public void setBorderLeft(String borderLeft)

                                             throws DOMException;

    /**

     *  See the border-top-color property definition in CSS2.

     */

    public String getBorderTopColor();

    /**

     *  See the border-top-color property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */

    public void setBorderTopColor(String borderTopColor)

                                             throws DOMException;

    /**

     *  See the border-right-color property definition in CSS2.

     */

    public String getBorderRightColor();

    /**

     *  See the border-right-color property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */

    public void setBorderRightColor(String borderRightColor)

                                             throws DOMException;

    /**

     *  See the border-bottom-color property definition in CSS2.

     */

    public String getBorderBottomColor();

    /**

     *  See the border-bottom-color property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */

    public void setBorderBottomColor(String borderBottomColor)

                                             throws DOMException;

    /**

     *  See the border-left-color property definition in CSS2.

     */

    public String getBorderLeftColor();

    /**

     *  See the border-left-color property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */

    public void setBorderLeftColor(String borderLeftColor)

                                             throws DOMException;

    /**

     *  See the border-top-style property definition in CSS2.

     */

    public String getBorderTopStyle();

    /**

     *  See the border-top-style property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */

    public void setBorderTopStyle(String borderTopStyle)

                                             throws DOMException;

    /**

     *  See the border-right-style property definition in CSS2.

     */

    public String getBorderRightStyle();

    /**

     *  See the border-right-style property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */

    public void setBorderRightStyle(String borderRightStyle)

                                             throws DOMException;

    /**

     *  See the border-bottom-style property definition in CSS2.

     */

    public String getBorderBottomStyle();

    /**

     *  See the border-bottom-style property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */

    public void setBorderBottomStyle(String borderBottomStyle)

                                             throws DOMException;

    /**

     *  See the border-left-style property definition in CSS2.

     */

    public String getBorderLeftStyle();

    /**

     *  See the border-left-style property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */

    public void setBorderLeftStyle(String borderLeftStyle)

                                             throws DOMException;

    /**

     *  See the border-top-width property definition in CSS2.

     */

    public String getBorderTopWidth();

    /**

     *  See the border-top-width property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */

    public void setBorderTopWidth(String borderTopWidth)

                                             throws DOMException;

    /**

     *  See the border-right-width property definition in CSS2.

     */

    public String getBorderRightWidth();

    /**

     *  See the border-right-width property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */

    public void setBorderRightWidth(String borderRightWidth)

                                             throws DOMException;

    /**

     *  See the border-bottom-width property definition in CSS2.

     */

    public String getBorderBottomWidth();

    /**

     *  See the border-bottom-width property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */

    public void setBorderBottomWidth(String borderBottomWidth)

                                             throws DOMException;

    /**

     *  See the border-left-width property definition in CSS2.

     */

    public String getBorderLeftWidth();

    /**

     *  See the border-left-width property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */

    public void setBorderLeftWidth(String borderLeftWidth)

                                             throws DOMException;

    /**

     *  See the border-width property definition in CSS2.

     */

    public String getBorderWidth();

    /**

     *  See the border-width property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */

    public void setBorderWidth(String borderWidth)

                                             throws DOMException;

    /**

     *  See the bottom property definition in CSS2.

     */

    public String getBottom();

    /**

     *  See the bottom property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */

    public void setBottom(String bottom)

                                             throws DOMException;

    /**

     *  See the caption-side property definition in CSS2.

     */

    public String getCaptionSide();

    /**

     *  See the caption-side property definition in CSS2.

     * @exception DOMException

     *   SYNTAX_ERR: Raised if the new value has a syntax error and is

     *   unparsable.

     *   <br>NO_MODIFICATION_ALLOWED_ERR: Raised if this property is readonly.

     */