IXpsOMPageReference::SetAdvisoryPageDimensions-Methode (xpsobjectmodel.h)

Legt die vorgeschlagenen Dimensionen der Seite fest.

Syntax

HRESULT SetAdvisoryPageDimensions(
  [in] const XPS_SIZE *pageDimensions
);

Parameter

[in] pageDimensions

Die vorgeschlagenen Dimensionen, die für die Seite festgelegt werden sollen.

Die Höhen- und Breitenmember müssen den Wert –1,0 oder einen Wert aufweisen, der größer oder gleich +1,0 ist.

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

Rückgabewert

Wenn die Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_POINTER	Entweder ist pageDimensionsNULL oder ein Feld in der XPS_SIZE-Struktur , auf die von pageDimensions verwiesen wird, enthält einen ungültigen Wert.
XPS_E_INVALID_PAGE_SIZE	Die in pageDimensions beschriebene Empfehlungsseitengröße war ungültig. Die Height - und Width-Elemente von pageDimensions müssen den Wert –1,0 oder einen Wert aufweisen, der größer oder gleich +1,0 ist.

Hinweise

Die Höhen- und Breitenmember der XPS_SIZE Struktur, auf die von pageDimensions verwiesen wird, müssen Werte aufweisen, die größer oder gleich +1,0 sind, wenn die Werte dieser Felder festgelegt werden sollen, oder –1,0, wenn dies nicht der Fall ist. Wenn beispielsweise eine Empfehlungsdimension nur für die Seitenbreite festgelegt werden soll, hätte pageDimensions.width den gewünschten Wert und pageDimensions.height den Wert –1,0.

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

IXpsOMPageReference

XML Paper Specification

XPS_SIZE