Interfaz IXpsOMPage (xpsobjectmodel.h)

Artículo
03/15/2023

Proporciona el nodo raíz de un árbol de objetos que contienen el contenido de una sola página.

La interfaz IXpsOMPage corresponde al elemento FixedPage en el marcado de documento XPS.

Herencia

La interfaz IXpsOMPage hereda de IXpsOMPart. IXpsOMPage también tiene estos tipos de miembros:

Métodos

La interfaz IXpsOMPage tiene estos métodos.


IXpsOMPage::Clone Realiza una copia profunda de la interfaz. (IXpsOMPage.Clone)
IXpsOMPage::GenerateUnusedLookupKey Genera un nombre único que un recurso puede usar como clave de búsqueda en un diccionario de recursos.
IXpsOMPage::GetBleedBox Obtiene las dimensiones del cuadro de sangr de la página.
IXpsOMPage::GetContentBox Obtiene las dimensiones del cuadro de contenido de la página.
IXpsOMPage::GetDictionary Obtiene un puntero a la interfaz IXpsOMDictionary resuelta asociada a esta página.
IXpsOMPage::GetDictionaryLocal Obtiene un puntero a la interfaz IXpsOMDictionary del diccionario local y no compartido asociado a esta página.
IXpsOMPage::GetDictionaryResource Obtiene un puntero a la interfaz IXpsOMRemoteDictionaryResource del recurso de diccionario compartido que usa esta página.
IXpsOMPage::GetIsHyperlinkTarget Obtiene un valor booleano que indica si la página es el destino de un hipervínculo.
IXpsOMPage::GetLanguage Obtiene la propiedad Language de la página.
IXpsOMPage::GetName Obtiene la propiedad Name de la página.
IXpsOMPage::GetOwner Obtiene un puntero a la interfaz IXpsOMPageReference que contiene la página.
IXpsOMPage::GetPageDimensions Obtiene las dimensiones de página.
IXpsOMPage::GetVisuals Obtiene un puntero a una interfaz IXpsOMVisualCollection que contiene una colección de objetos visuales de la página.
IXpsOMPage::SetBleedBox Establece las dimensiones del cuadro de sangr de la página.
IXpsOMPage::SetContentBox Establece las dimensiones del cuadro de contenido de la página.
IXpsOMPage::SetDictionaryLocal Establece el puntero de interfaz IXpsOMDictionary del recurso de diccionario local de la página.
IXpsOMPage::SetDictionaryResource Establece el puntero de interfaz IXpsOMRemoteDictionaryResource del recurso de diccionario remoto de la página.
IXpsOMPage::SetIsHyperlinkTarget Especifica si la página es el destino de un hipervínculo.
IXpsOMPage::SetLanguage Establece la propiedad Language de la página.
IXpsOMPage::SetName Establece la propiedad Name de esta página.
IXpsOMPage::SetPageDimensions Establece dimensiones de la página.
IXpsOMPage::Write Escribe la página en la secuencia especificada.

Comentarios

En el ejemplo de código siguiente se muestra cómo crear una instancia de esta 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
}

Para obtener información sobre el uso de esta interfaz en un programa, vea Create a Blank XPS OM and Navigate the XPS OM.

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