IXpsOMMatrixTransform interface

Article
06/01/2017

Specifies an affine matrix transform that can be applied to other objects in the object model.

When to implement

Never. Custom implementation of this interface is not supported.

Members

The IXpsOMMatrixTransform interface inherits from IXpsOMShareable. IXpsOMMatrixTransform also has these types of members:

Methods

Methods

The IXpsOMMatrixTransform interface has these methods.

Method	Description
Clone	Makes a deep copy of the interface.
GetMatrix	Gets the XPS_MATRIX structure, which specifies the transform matrix.
SetMatrix	Sets the XPS_MATRIX structure, which specifies the transform matrix.

Remarks

The code example that follows illustrates how to create an instance of this interface.

IXpsOMMatrixTransform    *newInterface;
// The following value is defined outside of 
// this example.
XPS_MATRIX        newMatrix;

// Note the implicit requirement that CoInitializeEx 
//  has previously been called from this thread.

hr = CoCreateInstance(
    __uuidof(XpsOMObjectFactory),
    NULL,
    CLSCTX_INPROC_SERVER,
    _uuidof(IXpsOMObjectFactory),
    reinterpret_cast<LPVOID*>(&xpsFactory)
    );

if (SUCCEEDED(hr))
{
    hr = xpsFactory->CreateMatrixTransform (
        &newMatrix,
        &newInterface);

    if (SUCCEEDED(hr))
    {
        // use newInterface

        newInterface->Release();
    }
    xpsFactory->Release();
}
else
{
    // evaluate HRESULT error returned in hr
}

Requirements

Minimum supported client	Windows 7, Windows Vista with SP2 and Platform Update for Windows Vista [desktop apps \| Windows Store apps]
Minimum supported server	Windows Server 2008 R2, Windows Server 2008 with SP2 and Platform Update for Windows Server 2008 [desktop apps \| Windows Store apps]
Header	Xpsobjectmodel.h
IDL	XpsObjectModel.idl