Interfaccia IXpsOMPage (xpsobjectmodel.h)

Articolo
12/22/2023

Fornisce il nodo radice di un albero di oggetti che contengono il contenuto di una singola pagina.

L'interfaccia IXpsOMPage corrisponde all'elemento FixedPage nel markup del documento XPS.

Ereditarietà

L'interfaccia IXpsOMPage eredita da IXpsOMPart. IXpsOMPage include anche questi tipi di membri:

Metodi

L'interfaccia IXpsOMPage include questi metodi.


IXpsOMPage::Clone Crea una copia completa dell'interfaccia. (IXpsOMPage.Clone)
IXpsOMPage::GenerateUnusedLookupKey Genera un nome univoco che può essere usato come chiave di ricerca da una risorsa in un dizionario risorse.
IXpsOMPage::GetBleedBox Ottiene le dimensioni della casella smarginata della pagina.
IXpsOMPage::GetContentBox Ottiene le dimensioni della casella di contenuto della pagina.
IXpsOMPage::GetDictionary Ottiene un puntatore all'interfaccia IXpsOMDictionary risolta associata a questa pagina.
IXpsOMPage::GetDictionaryLocal Ottiene un puntatore all'interfaccia IXpsOMDictionary del dizionario locale non condiviso associato a questa pagina.
IXpsOMPage::GetDictionaryResource Ottiene un puntatore all'interfaccia IXpsOMRemoteDictionaryResource della risorsa dizionario condivisa utilizzata da questa pagina.
IXpsOMPage::GetIsHyperlinkTarget Ottiene un valore booleano che indica se la pagina è la destinazione di un collegamento ipertestuale.
IXpsOMPage::GetLanguage Ottiene la proprietà Language della pagina.
IXpsOMPage::GetName Ottiene la proprietà Name della pagina.
IXpsOMPage::GetOwner Ottiene un puntatore all'interfaccia IXpsOMPageReference che contiene la pagina.
IXpsOMPage::GetPageDimensions Ottiene le dimensioni della pagina.
IXpsOMPage::GetVisuals Ottiene un puntatore a un'interfaccia IXpsOMVisualCollection che contiene un insieme di oggetti visivi della pagina.
IXpsOMPage::SetBleedBox Imposta le dimensioni della casella smarginata della pagina.
IXpsOMPage::SetContentBox Imposta le dimensioni della casella di contenuto della pagina.
IXpsOMPage::SetDictionaryLocal Imposta il puntatore all'interfaccia IXpsOMDictionary della risorsa dizionario locale della pagina.
IXpsOMPage::SetDictionaryResource Imposta il puntatore all'interfaccia IXpsOMRemoteDictionaryResource della risorsa dizionario remoto della pagina.
IXpsOMPage::SetIsHyperlinkTarget Specifica se la pagina è la destinazione di un collegamento ipertestuale.
IXpsOMPage::SetLanguage Imposta la proprietà Language della pagina.
IXpsOMPage::SetName Imposta la proprietà Name di questa pagina.
IXpsOMPage::SetPageDimensions Imposta le dimensioni della pagina.
IXpsOMPage::Write Scrive la pagina nel flusso specificato.

Commenti

L'esempio di codice seguente illustra come creare un'istanza di questa interfaccia.


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
}

Per informazioni sull'uso di questa interfaccia in un programma, vedere Create a Blank XPS OM and Navigate the XPS OM.For information about using this interface in a program, see Create a Blank XPS OM and Navigate the XPS OM.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	xpsobjectmodel.h