lib/classpath/external/w3c_dom/org/w3c/dom/css/CSSValue.java

   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      */
  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      */
  63     public void setCssText(String cssText)
  64                        throws DOMException;
  65
  66     /**
  67      *  A code defining the type of the value as defined above.
  68      */
  69     public short getCssValueType();
  70
  71 }