public interface CSSPrimitiveValue extends CSSValue
CSSPrimitiveValue interface represents a single CSS value
. This interface may be used to determine the value of a specific style
property currently set in a block or to set a specific style property
explicitly within the block. An instance of this interface might be
obtained from the getPropertyCSSValue method of the
CSSStyleDeclaration interface. A
CSSPrimitiveValue object only occurs in a context of a CSS
property.
Conversions are allowed between absolute values (from millimeters to
centimeters, from degrees to radians, and so on) but not between relative
values. (For example, a pixel value cannot be converted to a centimeter
value.) Percentage values can't be converted since they are relative to
the parent value (or another property value). There is one exception for
color percentage values: since a color percentage value is relative to
the range 0-255, a color percentage value can be converted to a number;
(see also the RGBColor interface).
See also the Document Object Model (DOM) Level 2 Style Specification.
| Modifier and Type | Field and Description |
|---|---|
static short |
CSS_ATTR
The value is a attribute function.
|
static short |
CSS_CM
The value is a length (cm).
|
static short |
CSS_COUNTER
The value is a counter or counters function.
|
static short |
CSS_DEG
The value is an angle (deg).
|
static short |
CSS_DIMENSION
The value is a number with an unknown dimension.
|
static short |
CSS_EMS
The value is a length (ems).
|
static short |
CSS_EXS
The value is a length (exs).
|
static short |
CSS_GRAD
The value is an angle (grad).
|
static short |
CSS_HZ
The value is a frequency (Hz).
|
static short |
CSS_IDENT
The value is an identifier.
|
static short |
CSS_IN
The value is a length (in).
|
static short |
CSS_KHZ
The value is a frequency (kHz).
|
static short |
CSS_MM
The value is a length (mm).
|
static short |
CSS_MS
The value is a time (ms).
|
static short |
CSS_NUMBER
The value is a simple number.
|
static short |
CSS_PC
The value is a length (pc).
|
static short |
CSS_PERCENTAGE
The value is a percentage.
|
static short |
CSS_PT
The value is a length (pt).
|
static short |
CSS_PX
The value is a length (px).
|
static short |
CSS_RAD
The value is an angle (rad).
|
static short |
CSS_RECT
The value is a rect function.
|
static short |
CSS_RGBCOLOR
The value is a RGB color.
|
static short |
CSS_S
The value is a time (s).
|
static short |
CSS_STRING
The value is a STRING.
|
static short |
CSS_UNKNOWN
The value is not a recognized CSS2 value.
|
static short |
CSS_URI
The value is a URI.
|
CSS_CUSTOM, CSS_INHERIT, CSS_PRIMITIVE_VALUE, CSS_VALUE_LIST| Modifier and Type | Method and Description |
|---|---|
Counter |
getCounterValue()
This method is used to get the Counter value.
|
float |
getFloatValue(short unitType)
This method is used to get a float value in a specified unit.
|
short |
getPrimitiveType()
The type of the value as defined by the constants specified above.
|
Rect |
getRectValue()
This method is used to get the Rect value.
|
RGBColor |
getRGBColorValue()
This method is used to get the RGB color.
|
java.lang.String |
getStringValue()
This method is used to get the string value.
|
void |
setFloatValue(short unitType,
float floatValue)
A method to set the float value with a specified unit.
|
void |
setStringValue(short stringType,
java.lang.String stringValue)
A method to set the string value with the specified unit.
|
getCssText, getCssValueType, setCssTextstatic final short CSS_UNKNOWN
cssText attribute.static final short CSS_NUMBER
getFloatValue method.static final short CSS_PERCENTAGE
getFloatValue method.static final short CSS_EMS
getFloatValue method.static final short CSS_EXS
getFloatValue method.static final short CSS_PX
getFloatValue method.static final short CSS_CM
getFloatValue method.static final short CSS_MM
getFloatValue method.static final short CSS_IN
getFloatValue method.static final short CSS_PT
getFloatValue method.static final short CSS_PC
getFloatValue method.static final short CSS_DEG
getFloatValue method.static final short CSS_RAD
getFloatValue method.static final short CSS_GRAD
getFloatValue method.static final short CSS_MS
getFloatValue method.static final short CSS_S
getFloatValue method.static final short CSS_HZ
getFloatValue method.static final short CSS_KHZ
getFloatValue method.static final short CSS_DIMENSION
getFloatValue method.static final short CSS_STRING
getStringValue method.static final short CSS_URI
getStringValue method.static final short CSS_IDENT
getStringValue method.static final short CSS_ATTR
getStringValue method.static final short CSS_COUNTER
getCounterValue method.static final short CSS_RECT
getRectValue method.static final short CSS_RGBCOLOR
getRGBColorValue method.short getPrimitiveType()
void setFloatValue(short unitType,
float floatValue)
throws DOMException
DOMException will be raised.unitType - A unit code as defined above. The unit code can only
be a float unit type (i.e. CSS_NUMBER,
CSS_PERCENTAGE, CSS_EMS,
CSS_EXS, CSS_PX, CSS_CM,
CSS_MM, CSS_IN, CSS_PT,
CSS_PC, CSS_DEG, CSS_RAD,
CSS_GRAD, CSS_MS, CSS_S,
CSS_HZ, CSS_KHZ,
CSS_DIMENSION).floatValue - The new float value.DOMException - INVALID_ACCESS_ERR: Raised if the attached property doesn't support
the float value or the unit type.
float getFloatValue(short unitType)
throws DOMException
DOMException is raised.unitType - A unit code to get the float value. The unit code can
only be a float unit type (i.e. CSS_NUMBER,
CSS_PERCENTAGE, CSS_EMS,
CSS_EXS, CSS_PX, CSS_CM,
CSS_MM, CSS_IN, CSS_PT,
CSS_PC, CSS_DEG, CSS_RAD,
CSS_GRAD, CSS_MS, CSS_S,
CSS_HZ, CSS_KHZ,
CSS_DIMENSION).DOMException - INVALID_ACCESS_ERR: Raised if the CSS value doesn't contain a float
value or if the float value can't be converted into the specified
unit.void setStringValue(short stringType,
java.lang.String stringValue)
throws DOMException
DOMException will be raised.stringType - A string code as defined above. The string code can
only be a string unit type (i.e. CSS_STRING,
CSS_URI, CSS_IDENT, and
CSS_ATTR).stringValue - The new string value.DOMException - INVALID_ACCESS_ERR: Raised if the CSS value doesn't contain a string
value or if the string value can't be converted into the specified
unit.
java.lang.String getStringValue()
throws DOMException
DOMException is raised. Some
properties (like 'font-family' or 'voice-family') convert a
whitespace separated list of idents to a string.primitiveType can only be a string unit type (i.e.
CSS_STRING, CSS_URI,
CSS_IDENT and CSS_ATTR).DOMException - INVALID_ACCESS_ERR: Raised if the CSS value doesn't contain a string
value.Counter getCounterValue() throws DOMException
DOMException is
raised. Modification to the corresponding style property can be
achieved using the Counter interface.DOMException - INVALID_ACCESS_ERR: Raised if the CSS value doesn't contain a
Counter value (e.g. this is not CSS_COUNTER).Rect getRectValue() throws DOMException
DOMException is raised.
Modification to the corresponding style property can be achieved
using the Rect interface.DOMException - INVALID_ACCESS_ERR: Raised if the CSS value doesn't contain a Rect
value. (e.g. this is not CSS_RECT).RGBColor getRGBColorValue() throws DOMException
DOMException is raised.
Modification to the corresponding style property can be achieved
using the RGBColor interface.DOMException - INVALID_ACCESS_ERR: Raised if the attached property can't return a
RGB color value (e.g. this is not CSS_RGBCOLOR).Copyright © 2014 Apache XML Project. All Rights Reserved.