IXpsOMPage-Schnittstelle (xpsobjectmodel.h)

Artikel
03/05/2024

Stellt den Stammknoten einer Struktur von -Objekten bereit, die den Inhalt einer einzelnen Seite enthalten.

Die IXpsOMPage-Schnittstelle entspricht dem FixedPage-Element im XPS-Dokumentmarkup.

Vererbung

Die IXpsOMPage-Schnittstelle erbt von IXpsOMPart. IXpsOMPage verfügt auch über folgende Membertypen:

Methoden

Die IXpsOMPage-Schnittstelle verfügt über diese Methoden.


IXpsOMPage::Clone Macht eine tiefe Kopie der Schnittstelle. (IXpsOMPage.Clone)
IXpsOMPage::GenerateUnusedLookupKey Generiert einen eindeutigen Namen, der von einer Ressource in einem Ressourcenwörterbuch als Nachschlageschlüssel verwendet werden kann.
IXpsOMPage::GetBleedBox Ruft die Abmessungen des Beschnittfelds der Seite ab.
IXpsOMPage::GetContentBox Ruft die Dimensionen des Inhaltsfelds der Seite ab.
IXpsOMPage::GetDictionary Ruft einen Zeiger auf die aufgelöste IXpsOMDictionary-Schnittstelle ab, die dieser Seite zugeordnet ist.
IXpsOMPage::GetDictionaryLocal Ruft einen Zeiger auf die IXpsOMDictionary-Schnittstelle des lokalen, nicht freigegebenen Wörterbuchs ab, das dieser Seite zugeordnet ist.
IXpsOMPage::GetDictionaryResource Ruft einen Zeiger auf die IXpsOMRemoteDictionaryResource-Schnittstelle der freigegebenen Wörterbuchressource ab, die von dieser Seite verwendet wird.
IXpsOMPage::GetIsHyperlinkTarget Ruft einen booleschen Wert ab, der angibt, ob die Seite das Ziel eines Links ist.
IXpsOMPage::GetLanguage Ruft die Language-Eigenschaft der Seite ab.
IXpsOMPage::GetName Ruft die Name-Eigenschaft der Seite ab.
IXpsOMPage::GetOwner Ruft einen Zeiger auf die IXpsOMPageReference-Schnittstelle ab, die die Seite enthält.
IXpsOMPage::GetPageDimensions Ruft die Seitendimensionen ab.
IXpsOMPage::GetVisuals Ruft einen Zeiger auf eine IXpsOMVisualCollection-Schnittstelle ab, die eine Auflistung der visuellen Objekte der Seite enthält.
IXpsOMPage::SetBleedBox Legt die Abmessungen des Beschnittfelds der Seite fest.
IXpsOMPage::SetContentBox Legt die Dimensionen des Inhaltsfelds der Seite fest.
IXpsOMPage::SetDictionaryLocal Legt den IXpsOMDictionary-Schnittstellenzeiger der lokalen Wörterbuchressource der Seite fest.
IXpsOMPage::SetDictionaryResource Legt den IXpsOMRemoteDictionaryResource-Schnittstellenzeiger der Remotewörterbuchressource der Seite fest.
IXpsOMPage::SetIsHyperlinkTarget Gibt an, ob die Seite das Ziel eines Links ist.
IXpsOMPage::SetLanguage Legt die Language-Eigenschaft der Seite fest.
IXpsOMPage::SetName Legt die Name-Eigenschaft dieser Seite fest.
IXpsOMPage::SetPageDimensions Legt die Dimensionen der Seite fest.
IXpsOMPage::Write Schreibt die Seite in den angegebenen Stream.

Hinweise

Im folgenden Codebeispiel wird veranschaulicht, wie Sie eine instance dieser Schnittstelle erstellen.


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
}

Informationen zur Verwendung dieser Schnittstelle in einem Programm finden Sie unter Erstellen eines leeren XPS-OM und Navigieren im XPS-OM.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	xpsobjectmodel.h