Source for org.w3c.dom.css.CSSValue

   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: }