convert_to_specified_units method

convert_to_specified_units

Preserve the same underlying stored value, but reset the stored unit identifier to the given 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”.

def convert_to_specified_units(self, unit_type):
    ...
ParameterTypeDescription
unit_typeintThe unit type to switch to (e.g., SVG_LENGTHTYPE_MM).

Exceptions

ExceptionDescription
DOMExceptionCode DOMException.NOT_SUPPORTED_ERR
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).
DOMExceptionCode DOMException.NO_MODIFICATION_ALLOWED_ERR
Raised when the length corresponds to a read only attribute or when the object itself is read only.

See Also