Metodo IXpsOMObjectFactory::CreateMatrixTransform (xpsobjectmodel.h)

Articolo
03/13/2024

Crea un'interfaccia IXpsOMMatrixTransform che specifica una trasformazione matrice affine.

Sintassi

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

Parametri

[in] matrix

Matrice iniziale da assegnare alla trasformazione.

[out, retval] transform

Puntatore alla nuova interfaccia IXpsOMMatrixTransform .

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a quelli della tabella che segue. Per informazioni sui valori restituiti dall'API documento XPS non elencati in questa tabella, vedere Errori del documento XPS.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.
E_POINTER	matrice o trasformazione è NULL.

Commenti

La trasformazione specificata da questa matrice può essere applicata alla proprietà transform di altri oggetti XPS.

L'esempio di codice seguente illustra come viene usato questo metodo per creare una nuova interfaccia.


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
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	xpsobjectmodel.h

Vedi anche

IXpsOMMatrixTransform

IXpsOMObjectFactory

XML Paper Specification

Errori del documento XPS

XPS_MATRIX

Condividi tramite