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

Crea una interfaz IXpsOMPage , que proporciona el nodo raíz de un árbol de objetos que representan el contenido de una sola página.

Sintaxis

HRESULT CreatePage(
  [in]          const XPS_SIZE *pageDimensions,
  [in]          LPCWSTR        language,
  [in]          IOpcPartUri    *partUri,
  [out, retval] IXpsOMPage     **page
);

Parámetros

[in] pageDimensions

Estructura XPS_SIZE que especifica el tamaño de la página que se va a crear.

El tamaño se describe en unidades XPS. Hay 96 unidades XPS por pulgada. Por ejemplo, las dimensiones de una página de 8,5" en 11,0" son 816 por 1056 unidades XPS.

[in] language

Cadena que indica el idioma predeterminado de la página creada.

Importante La cadena de lenguaje debe seguir la sintaxis RFC 3066.

 

[in] partUri

Interfaz IOpcPartUri que contiene el nombre del elemento que se va a asignar a este recurso.

[out, retval] page

Puntero a la nueva interfaz IXpsOMPage .

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	pageDimensions, partUri o page es NULL.
XPS_E_INVALID_LANGUAGE	language no contiene una cadena de idioma válida.
XPS_E_INVALID_PAGE_SIZE	pageDimensions contiene un tamaño de página no válido o valores de tamaño de página no válidos.

Comentarios

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

IXpsOMPage        *newInterface;
// The following values are defined outside of 
// this example.
//  LPWSTR        language;
//  XPS_SIZE      pageDimensions;

// 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->CreatePartUri(partUriString, &partUri);
    if (SUCCEEDED(hr))
    {
        hr = xpsFactory->CreatePage (
            &pageDimensions,
            language,
            partUri,
            &newInterface);

        if (SUCCEEDED(hr))
        {
            // use newInterface

            newInterface->Release();
        }
        partUri->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

Consulte también

IXpsOMObjectFactory

The Internet Engineering Task Force (IETF) RFC 3066

XML Paper Specification

Errores del documento XPS