IXpsOMObjectFactory::CreateMatrixTransform 메서드(xpsobjectmodel.h)

아핀 행렬 변환을 지정하는 IXpsOMMatrixTransform 인터페이스를 만듭니다.

구문

HRESULT CreateMatrixTransform(
  [in]          const XPS_MATRIX      *matrix,
  [out, retval] IXpsOMMatrixTransform **transform
);

매개 변수

[in] matrix

변환에 할당할 초기 행렬입니다.

[out, retval] transform

새 IXpsOMMatrixTransform 인터페이스에 대한 포인터입니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값은 다음 표에 있는 값을 포함하지만 이에 국한되지 않습니다. 이 표에 나열되지 않은 XPS 문서 API 반환 값에 대한 자세한 내용은 XPS 문서 오류를 참조하세요.

설명

이 행렬에 지정된 변환은 다른 XPS 개체의 변환 속성에 적용할 수 있습니다.

다음 코드 예제에서는 이 메서드를 사용하여 새 인터페이스를 만드는 방법을 보여 줍니다.

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
}

요구 사항

추가 정보

IXpsOMMatrixTransform

IXpsOMObjectFactory

XML Paper Specification

XPS 문서 오류

XPS_MATRIX