Interface IXpsOMPage (xpsobjectmodel.h)

Artigo
08/28/2023

Fornece o nó raiz de uma árvore de objetos que contém o conteúdo de uma única página.

A interface IXpsOMPage corresponde ao elemento FixedPage na marcação de documento XPS.

Herança

A interface IXpsOMPage herda de IXpsOMPart. O IXpsOMPage também tem estes tipos de membros:

Métodos

A interface IXpsOMPage tem esses métodos.


IXpsOMPage::Clone Faz uma cópia profunda da interface. (IXpsOMPage.Clone)
IXpsOMPage::GenerateUnusedLookupKey Gera um nome exclusivo que pode ser usado como uma chave de pesquisa por um recurso em um dicionário de recursos.
IXpsOMPage::GetBleedBox Obtém as dimensões da caixa de sangramento da página.
IXpsOMPage::GetContentBox Obtém as dimensões da caixa de conteúdo da página.
IXpsOMPage::GetDictionary Obtém um ponteiro para a interface IXpsOMDictionary resolvida associada a esta página.
IXpsOMPage::GetDictionaryLocal Obtém um ponteiro para a interface IXpsOMDictionary do dicionário local não coletado associado a esta página.
IXpsOMPage::GetDictionaryResource Obtém um ponteiro para a interface IXpsOMRemoteDictionaryResource do recurso de dicionário compartilhado usado por esta página.
IXpsOMPage::GetIsHyperlinkTarget Obtém um valor booliano que indica se a página é o destino de um hiperlink.
IXpsOMPage::GetLanguage Obtém a propriedade Language da página.
IXpsOMPage::GetName Obtém a propriedade Name da página.
IXpsOMPage::GetOwner Obtém um ponteiro para a interface IXpsOMPageReference que contém a página.
IXpsOMPage::GetPageDimensions Obtém as dimensões da página.
IXpsOMPage::GetVisuals Obtém um ponteiro para uma interface IXpsOMVisualCollection que contém uma coleção de objetos visuais da página.
IXpsOMPage::SetBleedBox Define as dimensões da caixa de sangramento da página.
IXpsOMPage::SetContentBox Define as dimensões da caixa de conteúdo da página.
IXpsOMPage::SetDictionaryLocal Define o ponteiro da interface IXpsOMDictionary do recurso de dicionário local da página.
IXpsOMPage::SetDictionaryResource Define o ponteiro da interface IXpsOMRemoteDictionaryResource do recurso de dicionário remoto da página.
IXpsOMPage::SetIsHyperlinkTarget Especifica se a página é o destino de um hiperlink.
IXpsOMPage::SetLanguage Define a propriedade Language da página.
IXpsOMPage::SetName Define a propriedade Name desta página.
IXpsOMPage::SetPageDimensions Define dimensões da página.
IXpsOMPage::Write Grava a página no fluxo especificado.

Comentários

O exemplo de código a seguir ilustra como criar uma instância dessa interface.


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 obter informações sobre como usar essa interface em um programa, consulte Criar um OM XPS em branco e Navegar no OM XPS.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [aplicativos da área de trabalho \| Aplicativos UWP]
Servidor mínimo com suporte	Windows Server 2008 R2, Windows Server 2008 com SP2 e Atualização de Plataforma para Windows Server 2008 [aplicativos da área de trabalho \| Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	xpsobjectmodel.h