1 /*

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

     3  *

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

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

     6  * published by the Free Software Foundation.  Sun designates this

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

     8  * by Sun in the LICENSE file that accompanied this code.

     9  *

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

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

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

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

    14  * accompanied this code).

    15  *

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

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

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

    19  *

    20  * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,

    21  * CA 95054 USA or visit www.sun.com if you need additional information or

    22  * have any questions.

    23  */

    24 

    25 /*

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

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

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

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

    30  *

    31  * Copyright (c) 2000 World Wide Web Consortium,

    32  * (Massachusetts Institute of Technology, Institut National de

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

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

    35  * Intellectual Property License. This program is distributed in the

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

    37  * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR

    38  * PURPOSE.

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

    40  */

    41 

    42 package org.w3c.dom.css;

    43 

    44 import org.w3c.dom.DOMException;

    45 

    46 /**

    47  *  The <code>CSSValue</code> interface represents a simple or a complex

    48  * value. A <code>CSSValue</code> object only occurs in a context of a CSS

    49  * property.

    50  * <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>.

    51  * @since DOM Level 2

    52  */

    53 public interface CSSValue {

    54     // UnitTypes

    55     /**

    56      * The value is inherited and the <code>cssText</code> contains "inherit".

    57      */

    58     public static final short CSS_INHERIT               = 0;

    59     /**

    60      * The value is a primitive value and an instance of the

    61      * <code>CSSPrimitiveValue</code> interface can be obtained by using

    62      * binding-specific casting methods on this instance of the

    63      * <code>CSSValue</code> interface.

    64      */

    65     public static final short CSS_PRIMITIVE_VALUE       = 1;

    66     /**

    67      * The value is a <code>CSSValue</code> list and an instance of the

    68      * <code>CSSValueList</code> interface can be obtained by using

    69      * binding-specific casting methods on this instance of the

    70      * <code>CSSValue</code> interface.

    71      */

    72     public static final short CSS_VALUE_LIST            = 2;

    73     /**

    74      * The value is a custom value.

    75      */

    76     public static final short CSS_CUSTOM                = 3;

    77 

    78     /**

    79      *  A string representation of the current value.

    80      */

    81     public String getCssText();

    82     /**

    83      *  A string representation of the current value.

    84      * @exception DOMException

    85      *    SYNTAX_ERR: Raised if the specified CSS string value has a syntax

    86      *   error (according to the attached property) or is unparsable.

    87      *   <br>INVALID_MODIFICATION_ERR: Raised if the specified CSS string

    88      *   value represents a different type of values than the values allowed

    89      *   by the CSS property.

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

    91      */

    92     public void setCssText(String cssText)

    93                        throws DOMException;

    94 

    95     /**

    96      *  A code defining the type of the value as defined above.

    97      */

    98     public short getCssValueType();

    99 

   100 }