IXpsOMObjectFactory::CreatePageReference-Methode (xpsobjectmodel.h)

Erstellt eine IXpsOMPageReference-Schnittstelle , die die Virtualisierung von Seiten ermöglicht.

Syntax

HRESULT CreatePageReference(
  [in]          const XPS_SIZE      *advisoryPageDimensions,
  [out, retval] IXpsOMPageReference **pageReference
);

Parameter

[in] advisoryPageDimensions

Die XPS_SIZE-Struktur , die die Seitendimensionen (Seitenbreite und Seitenhöhe) festlegt.

Die Größe wird in XPS-Einheiten beschrieben. Es gibt 96 XPS-Einheiten pro Zoll. Beispielsweise sind die Abmessungen einer Seite mit 8,5 zoll x 11,0 Zoll 816 x 1.056 XPS-Einheiten.

[out, retval] pageReference

Ein Zeiger auf die neue IXpsOMPageReference-Schnittstelle .

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem die Werte in der folgenden Tabelle. Informationen zu XPS-Dokument-API-Rückgabewerten, die in dieser Tabelle nicht aufgeführt sind, finden Sie unter XPS-Dokumentfehler.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_POINTER	advisoryPageDimensions oder pageReference ist NULL.
XPS_E_INVALID_PAGE_SIZE	advisoryPageDimensions enthält eine ungültige Seitengröße oder ungültige Seitengrößenwerte.

Hinweise

Die Verwendung eines Seitenverweis ermöglicht es, das Laden des vollständigen Objektmodells einer Seite zu verzögern, bis das Laden explizit angefordert wird. Wenn die Seite nicht geändert wurde, kann sie auf Anforderung entladen werden.

Das folgende Codebeispiel veranschaulicht, wie diese Methode zum Erstellen einer neuen Schnittstelle verwendet wird.

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
}

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

Weitere Informationen

IXpsOMObjectFactory

IXpsOMPageReference

XML Paper Specification

XPS-Dokumentfehler

XPS_SIZE