IXpsOMPageReference-Schnittstelle (xpsobjectmodel.h)

Artikel
08/28/2023

Ermöglicht die Virtualisierung von Seiten in einem XPS-Dokument.

Ein Seitenverweis verschiebt das Laden des vollständigen Objektmodells einer Seite, bis die Seite angefordert wird. Wenn die Seite nicht geändert wurde, kann sie auch auf Anforderung entladen werden.

Vererbung

Die IXpsOMPageReference-Schnittstelle erbt von der IUnknown-Schnittstelle . IXpsOMPageReference verfügt auch über folgende Membertypen:

Methoden

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


IXpsOMPageReference::Clone Erstellt eine ausführliche Kopie der Schnittstelle. (IXpsOMPageReference.Clone)
IXpsOMPageReference::CollectLinkTargets Ruft eine IXpsOMNameCollection-Schnittstelle ab, die die Namen aller Dokumentunterbaumobjekte enthält, deren IsHyperlinkTarget-Eigenschaft auf TRUE festgelegt ist.
IXpsOMPageReference::CollectPartResources Erstellt eine Liste aller teilbasierten Ressourcen, die der Seite zugeordnet sind.
IXpsOMPageReference::D iscardPage Verwirft die Seite aus dem Arbeitsspeicher.
IXpsOMPageReference::GetAdvisoryPageDimensions Ruft die vorgeschlagenen Dimensionen der Seite ab.
IXpsOMPageReference::GetOwner Ruft einen Zeiger auf die IXpsOMDocument-Schnittstelle ab, die den Seitenverweis enthält.
IXpsOMPageReference::GetPage Ruft einen Zeiger auf die IXpsOMPage-Schnittstelle ab, die die Seite enthält.
IXpsOMPageReference::GetPrintTicketResource Ruft einen Zeiger auf die IXpsOMPrintTicketResource-Schnittstelle der Druckticketressource auf Seitenebene ab, die der Seite zugeordnet ist.
IXpsOMPageReference::GetStoryFragmentsResource Ruft einen Zeiger auf die IXpsOMStoryFragmentsResource-Schnittstelle der StoryFragments-Teilressource ab, die der Seite zugeordnet ist.
IXpsOMPageReference::GetThumbnailResource Ruft einen Zeiger auf die IXpsOMImageResource-Schnittstelle der Miniaturbildressource ab, die der Seite zugeordnet ist.
IXpsOMPageReference::HasRestrictedFonts Ruft einen booleschen Wert ab, der angibt, ob die Dokumentunterstruktur der Seite, auf die verwiesen wird, Glyphen enthält, die über eine Schriftartressource verfügen, deren EmbeddingOption-Eigenschaft auf XPS_FONT_EMBEDDING_RESTRICTED festgelegt ist.
IXpsOMPageReference::IsPageLoaded Ruft die Seite ab, auf die verwiesen wird, status, die angibt, ob die Seite geladen wird.
IXpsOMPageReference::SetAdvisoryPageDimensions Legt die vorgeschlagenen Dimensionen der Seite fest.
IXpsOMPageReference::SetPage Legt die IXpsOMPage-Schnittstelle des Seitenverweiss fest.
IXpsOMPageReference::SetPrintTicketResource Legt den IXpsOMPrintTicketResource-Schnittstellenzeiger der Druckticketressource auf Seitenebene fest, die der Seite zugewiesen werden soll.
IXpsOMPageReference::SetStoryFragmentsResource Legt den IXpsOMStoryFragmentsResource-Schnittstellenzeiger der StoryFragments-Ressource fest, die der Seite zugewiesen werden soll.
IXpsOMPageReference::SetThumbnailResource Legt den Zeiger auf die IXpsOMImageResource-Schnittstelle der Miniaturbildressource fest, die der Seite zugewiesen werden soll.

Hinweise

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


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
}

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

Anforderungen


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