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

Article
03/13/2024

Crée une interface IXpsOMGeometryFigure , qui spécifie une partie d’un objet définie par une interface IXpsOMGeometry .

Syntaxe

HRESULT CreateGeometryFigure(
  [in]          const XPS_POINT      *startPoint,
  [out, retval] IXpsOMGeometryFigure **figure
);

Paramètres

[in] startPoint

Coordonnées du point de départ de la figure géométrique.

[out, retval] figure

Pointeur vers la nouvelle interface IXpsOMGeometryFigure .

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.

Code de retour	Description
S_OK	S_OK
E_POINTER	startPoint ou figure a la valeur NULL.
XPS_E_INVALID_FLOAT	L’un des champs de la structure XPS_POINT passé dans startPoint contient une valeur qui n’est pas valide.

Remarques

L’exemple de code qui suit illustre comment cette méthode est utilisée pour créer une interface.


IXpsOMGeometryFigure    *newInterface;
// startPoint contains the starting point
// of the geometry figure being created
XPS_POINT                startPoint = {0,0};

// 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->CreateGeometryFigure (&startPoint, &newInterface);
    if (SUCCEEDED(hr))
    {
        // use newInterface

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7, Windows Vista avec SP2 et Mise à jour de plateforme pour Windows Vista [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2, Windows Server 2008 avec SP2 et Mise à jour de plateforme pour Windows Server 2008 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	xpsobjectmodel.h