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

Artículo
03/09/2024

Crea una interfaz IXpsOMGeometryFigure , que especifica una parte de un objeto definido por una interfaz IXpsOMGeometry .

Sintaxis

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

Parámetros

[in] startPoint

Coordenadas del punto inicial de la figura de geometría.

[out, retval] figure

Puntero a la nueva interfaz IXpsOMGeometryFigure .

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen, entre otros, los de la tabla siguiente. Para obtener información sobre los valores devueltos de la API de documentos XPS que no aparecen en esta tabla, vea Errores del documento XPS.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_POINTER	startPoint o figura es NULL.
XPS_E_INVALID_FLOAT	Uno de los campos de la estructura XPS_POINT que se pasa en startPoint contiene un valor que no es válido.

Comentarios

En el ejemplo de código siguiente se muestra cómo se usa este método para crear una nueva interfaz.


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
}

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	xpsobjectmodel.h