Méthode IXpsOMObjectFactory ::CreateMatrixTransform (xpsobjectmodel.h)

Crée une interface IXpsOMMatrixTransform qui spécifie une transformation de matrice affine.

Syntaxe

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

Paramètres

[in] matrix

Matrice initiale à affecter à la transformation.

[out, retval] transform

Pointeur vers la nouvelle interface IXpsOMMatrixTransform .

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles incluent, sans s’y limiter, celles de la table qui suit. Pour plus d’informations sur les valeurs de retour de l’API de document XPS qui ne sont pas répertoriées dans ce tableau, consultez Erreurs de document XPS.

Remarques

La transformation spécifiée par cette matrice peut être appliquée à la propriété transform d’autres objets XPS.

L’exemple de code qui suit illustre comment cette méthode est utilisée pour créer une 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
}

Configuration requise

Voir aussi

IXpsOMMatrixTransform

IXpsOMObjectFactory

XML Paper Specification

Erreurs de document XPS

XPS_MATRIX