1 /*
2  * Copyright (c) 2000 World Wide Web Consortium,
3  * (Massachusetts Institute of Technology, Institut National de
4  * Recherche en Informatique et en Automatique, Keio University). All
5  * Rights Reserved. This program is distributed under the W3C's Software
6  * Intellectual Property License. This program is distributed in the
7  * hope that it will be useful, but WITHOUT ANY WARRANTY; without even
8  * the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
9  * PURPOSE.
10  * See W3C License http://www.w3.org/Consortium/Legal/ for more details.
11  */
12 
13 package org.w3c.dom.css;
14 
15 import org.w3c.dom.DOMException;
16 
17 /**
18  *  The <code>CSSValue</code> interface represents a simple or a complex
19  * value. A <code>CSSValue</code> object only occurs in a context of a CSS
20  * property.
21  * <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>.
22  * @since DOM Level 2
23  */
24 public interface CSSValue {
25     // UnitTypes
26     /**
27      * The value is inherited and the <code>cssText</code> contains "inherit".
28      */
29     public static final short CSS_INHERIT               = 0;
30     /**
31      * The value is a primitive value and an instance of the
32      * <code>CSSPrimitiveValue</code> interface can be obtained by using
33      * binding-specific casting methods on this instance of the
34      * <code>CSSValue</code> interface.
35      */
36     public static final short CSS_PRIMITIVE_VALUE       = 1;
37     /**
38      * The value is a <code>CSSValue</code> list and an instance of the
39      * <code>CSSValueList</code> interface can be obtained by using
40      * binding-specific casting methods on this instance of the
41      * <code>CSSValue</code> interface.
42      */
43     public static final short CSS_VALUE_LIST            = 2;
44     /**
45      * The value is a custom value.
46      */
47     public static final short CSS_CUSTOM                = 3;
48 
49     /**
50      *  A string representation of the current value.
51      */
getCssText()52     public String getCssText();
53     /**
54      *  A string representation of the current value.
55      * @exception DOMException
56      *    SYNTAX_ERR: Raised if the specified CSS string value has a syntax
57      *   error (according to the attached property) or is unparsable.
58      *   <br>INVALID_MODIFICATION_ERR: Raised if the specified CSS string
59      *   value represents a different type of values than the values allowed
60      *   by the CSS property.
61      *   <br> NO_MODIFICATION_ALLOWED_ERR: Raised if this value is readonly.
62      */
setCssText(String cssText)63     public void setCssText(String cssText)
64                        throws DOMException;
65 
66     /**
67      *  A code defining the type of the value as defined above.
68      */
getCssValueType()69     public short getCssValueType();
70 
71 }
72