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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Entweder ist pageDimensionsNULL oder ein Feld in der XPS_SIZE-Struktur , auf die von pageDimensions verwiesen wird, enthält einen ungültigen Wert. |
|
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 |