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.  Oracle designates this
7  * particular file as subject to the "Classpath" exception as provided
8  * by Oracle 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 Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
21  * or visit www.oracle.com if you need additional information or have any
22  * 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 1.4, 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      */
getCssText()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      */
setCssText(String cssText)92     public void setCssText(String cssText)
93                        throws DOMException;
94 
95     /**
96      *  A code defining the type of the value as defined above.
97      */
getCssValueType()98     public short getCssValueType();
99 
100 }
101