Interfaz IXpsOMPageReference (xpsobjectmodel.h)

Artículo
08/28/2023

Habilita la virtualización de páginas en un documento XPS.

Una referencia de página aplaza la carga del modelo de objetos completo de una página hasta que se solicite la página. Si la página no se ha modificado, también se puede descargar a petición.

Herencia

La interfaz IXpsOMPageReference hereda de la interfaz IUnknown . IXpsOMPageReference también tiene estos tipos de miembros:

Métodos

La interfaz IXpsOMPageReference tiene estos métodos.


IXpsOMPageReference::Clone Realiza una copia profunda de la interfaz. (IXpsOMPageReference.Clone)
IXpsOMPageReference::CollectLinkTargets Obtiene una interfaz IXpsOMNameCollection que contiene los nombres de todos los objetos de subárbol del documento cuya propiedad IsHyperlinkTarget se establece en TRUE.
IXpsOMPageReference::CollectPartResources Crea una lista de todos los recursos basados en partes asociados a la página.
IXpsOMPageReference::D iscardPage Descarta la página de la memoria.
IXpsOMPageReference::GetAdvisoryPageDimensions Obtiene las dimensiones sugeridas de la página.
IXpsOMPageReference::GetOwner Obtiene un puntero a la interfaz IXpsOMDocument que contiene la referencia de página.
IXpsOMPageReference::GetPage Obtiene un puntero a la interfaz IXpsOMPage que contiene la página.
IXpsOMPageReference::GetPrintTicketResource Obtiene un puntero a la interfaz IXpsOMPrintTicketResource del recurso de vale de impresión de nivel de página asociado a la página.
IXpsOMPageReference::GetStoryFragmentsResource Obtiene un puntero a la interfaz IXpsOMStoryFragmentsResource del recurso de elemento StoryFragments asociado a la página.
IXpsOMPageReference::GetThumbnailResource Obtiene un puntero a la interfaz IXpsOMImageResource del recurso de imagen en miniatura asociado a la página.
IXpsOMPageReference::HasRestrictedFonts Obtiene un valor booleano que indica si el subárbol del documento de la página a la que se hace referencia incluye cualquier glifo que tenga un recurso de fuente cuya propiedad EmbeddingOption esté establecida en XPS_FONT_EMBEDDING_RESTRICTED.
IXpsOMPageReference::IsPageLoaded Obtiene el estado de página al que se hace referencia, que indica si se carga la página.
IXpsOMPageReference::SetAdvisoryPageDimensions Establece las dimensiones sugeridas de la página.
IXpsOMPageReference::SetPage Establece la interfaz IXpsOMPage de la referencia de página.
IXpsOMPageReference::SetPrintTicketResource Establece el puntero de la interfaz IXpsOMPrintTicketResource del recurso de vale de impresión de nivel de página que se va a asignar a la página.
IXpsOMPageReference::SetStoryFragmentsResource Establece el puntero de interfaz IXpsOMStoryFragmentsResource del recurso StoryFragments que se asignará a la página.
IXpsOMPageReference::SetThumbnailResource Establece el puntero a la interfaz IXpsOMImageResource del recurso de imagen en miniatura que se asignará a la página.

Comentarios

En el ejemplo de código siguiente se muestra cómo crear una instancia de esta interfaz.


IXpsOMPageReference    *newInterface;
// The following value is defined outside of 
// this example.
XPS_SIZE        advisoryPageDimensions;

// 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->CreatePageReference (
        &advisoryPageDimensions,
        &newInterface);

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

        newInterface->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


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