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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
advisoryPageDimensions oder pageReference ist NULL. |
|
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 |