public interface SVGLength
The SVGLength
interface correspond to the <length> basic data type.
An SVGLength
object can be designated as read only, which means that attempts to modify the object will result in an exception being thrown.
Modifier and Type | Field and Description |
---|---|
static int |
SVG_LENGTHTYPE_CM
A value was specified using the cm units defined in CSS2.
|
static int |
SVG_LENGTHTYPE_EMS
A value was specified using the em units defined in CSS2.
|
static int |
SVG_LENGTHTYPE_EXS
A value was specified using the ex units defined in CSS2.
|
static int |
SVG_LENGTHTYPE_IN
A value was specified using the in units defined in CSS2.
|
static int |
SVG_LENGTHTYPE_MM
A value was specified using the mm units defined in CSS2.
|
static int |
SVG_LENGTHTYPE_NUMBER
No unit type was provided (i.e., a unitless value was specified), which indicates a value in user units.
|
static int |
SVG_LENGTHTYPE_PC
A value was specified using the pc units defined in CSS2.
|
static int |
SVG_LENGTHTYPE_PERCENTAGE
A percentage value was specified.
|
static int |
SVG_LENGTHTYPE_PT
A value was specified using the pt units defined in CSS2.
|
static int |
SVG_LENGTHTYPE_PX
A value was specified using the px units defined in CSS2.
|
static int |
SVG_LENGTHTYPE_UNKNOWN
The unit type is not one of predefined unit types.
|
Modifier and Type | Method and Description |
---|---|
void |
convertToSpecifiedUnits(int unitType)
Preserve the same underlying stored value, but reset the stored unit identifier to the given
unitType . |
int |
getUnitType()
The type of the value as specified by one of the SVG_LENGTHTYPE_* constants defined on this interface.
|
float |
getValue()
The value as a floating point value, in user units.
|
String |
getValueAsString()
The value as a string value, in the units expressed by
unitType . |
float |
getValueInSpecifiedUnits()
The value as a floating point value, in the units expressed by
unitType . |
void |
newValueSpecifiedUnits(int unitType,
float valueInSpecifiedUnits)
Reset the value as a number with an associated unitType, thereby replacing the values for all of the attributes on the object.
|
void |
setValue(float arg) |
void |
setValueAsString(String arg) |
void |
setValueInSpecifiedUnits(float arg) |
static final int SVG_LENGTHTYPE_CM
static final int SVG_LENGTHTYPE_EMS
static final int SVG_LENGTHTYPE_EXS
static final int SVG_LENGTHTYPE_IN
static final int SVG_LENGTHTYPE_MM
static final int SVG_LENGTHTYPE_NUMBER
static final int SVG_LENGTHTYPE_PC
static final int SVG_LENGTHTYPE_PERCENTAGE
static final int SVG_LENGTHTYPE_PT
static final int SVG_LENGTHTYPE_PX
static final int SVG_LENGTHTYPE_UNKNOWN
int getUnitType()
float getValue()
The value as a floating point value, in user units. Setting this attribute will cause valueInSpecifiedUnits
and valueAsString
to be updated automatically to reflect this setting.
Exceptions on setting: a DOMException
with code NO_MODIFICATION_ALLOWED_ERR
is raised when the length corresponds to a read only attribute or when the object itself is read only.
void setValue(float arg)
String getValueAsString()
The value as a string value, in the units expressed by unitType
. Setting this attribute will cause value
, valueInSpecifiedUnits
and unitType
to be updated automatically to reflect this setting.
Exceptions on setting:
DOMException
with code SYNTAX_ERR
is raised if the assigned string cannot be parsed as a valid <length>.DOMException
with code NO_MODIFICATION_ALLOWED_ERR
is raised when the length corresponds to a read only attribute or when the object itself is read only.void setValueAsString(String arg)
float getValueInSpecifiedUnits()
The value as a floating point value, in the units expressed by unitType
. Setting this attribute will cause value
and valueAsString
to be updated automatically to reflect this setting.
Exceptions on setting: a DOMException
with code NO_MODIFICATION_ALLOWED_ERR
is raised when the length corresponds to a read only attribute or when the object itself is read only.
void setValueInSpecifiedUnits(float arg)
void convertToSpecifiedUnits(int unitType)
unitType
. Object attributes unitType
, valueInSpecifiedUnits
and valueAsString
might be modified as a result of this method. For example, if the original value were "0.5cm" and the method was invoked to convert to millimeters, then the unitType
would be changed to SVG_LENGTHTYPE_MM
, valueInSpecifiedUnits
would be changed to the numeric value 5 and valueAsString
would be changed to "5mm".void newValueSpecifiedUnits(int unitType, float valueInSpecifiedUnits)
Reset the value as a number with an associated unitType, thereby replacing the values for all of the attributes on the object.
Exceptions:
DOMException
with code NOT_SUPPORTED_ERR
is raised if unitType
is SVG_LENGTHTYPE_UNKNOWN
or not a valid unit type constant (one of the other SVG_LENGTHTYPE_*
constants defined on this interface).DOMException
with code NO_MODIFICATION_ALLOWED_ERR
is raised when the length corresponds to a read only attribute or when the object itself is read only.Copyright © 2016. All rights reserved.