setMatrix method

Sets the transform type to SVG_TRANSFORM_MATRIX by using the specified new transformation.

Scalable Vector Graphics: Coordinate Systems, Transformations and Units, Section 7.14.4

Syntax

var retval = SVGTransform.setMatrix(matrix);

Parameters

matrix [in]

Type: ISVGMatrix

A matrix that defines the new transformation.

Return value

Type: HRESULT

This method can return one of these values.

Return code	Description
W3CException_DOM_NO_MODIFICATION_ALLOWED_ERR	IE9 mode only. An attempt is made to modify an object that cannot be changed.

Return code

Description

W3CException_DOM_NO_MODIFICATION_ALLOWED_ERR

IE9 mode only.

An attempt is made to modify an object that cannot be changed.

Exceptions

Exception	Condition
NoModificationAllowedError	An attempt is made to modify an object that cannot be changed. For versions earlier than Internet Explorer 10, NO_MODIFICATION_ALLOWED_ERR is returned.

Standards information

Scalable Vector Graphics: Coordinate Systems, Transformations and Units, Section 7.14.4

Remarks

The setMatrix method can raise a DOMException exception with the code NO_MODIFICATION_ALLOWED_ERR. This exception is raised if you try to change the value of a read-only attribute.

The values from the matrix parameter are copied, but the matrix parameter does not replace the matrix value.