IXRMatrix::IsIdentity (Compact 2013)

3/28/2014

This method retrieves a value that indicates whether this matrix is an identity matrix.

Syntax

virtual HRESULT STDMETHODCALLTYPE IsIdentity(
    bool* pValue
) = 0;

Parameters

• pValue
  [out] Pointer to a Boolean that is true if this matrix is an identity matrix; otherwise, it is false.

Return Value

Returns an HRESULT that indicates success or failure.

Remarks

When you apply an identity matrix to an object, the object is unchanged. Matrices that modify quadrants and change offset values use an identity matrix as a starting point to create rotations, translations, and other transformations.

An identity matrix correlates to supplying a value of 1 to both IXRMatrix::SetM11 and IXRMatrix::SetM22, and supplying a value of 0 to IXRMatrix::SetM12, IXRMatrix::SetM21, IXRMatrix::SetOffsetX, and IXRMatrix::SetOffsetY.

.NET Framework Equivalent

System.Windows.Media.Matrix.IsIdentity

Requirements

See Also

Reference

IXRMatrix