IXpsOMPage::SetContentBox-Methode (xpsobjectmodel.h)
Legt die Dimensionen des Inhaltsfelds der Seite fest.
Syntax
HRESULT SetContentBox(
[in] const XPS_RECT *contentBox
);
Parameter
[in] contentBox
Die Dimensionen des Inhaltsfelds der Seite.
| contentBox-Feld | Gültige Werte |
|---|---|
| contentBox.width | Größer als oder gleich 0,0 und kleiner als oder gleich (pageDimensions.width - contentBox.x). |
| contentBox.height | Größer oder gleich 0,0 und kleiner als oder gleich (pageDimensions.height - contentBox.y). |
| contentBox.x | Größer als oder gleich 0,0 und kleiner als pageDimensions.width. |
| contentBox.y | Größer als oder gleich 0,0 und kleiner als pageDimensions.height. |
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. |
|
contentBox ist NULL. |
|
Das von contentBox angegebene Rechteck enthält mindestens einen wert, der ungültig ist. |
Hinweise
Das Inhaltsfeld gibt an, wo Freihand auf der Seite angezeigt wird.
Die Inhaltsfelddimensionen werden erst dann anhand der Seitendimensionen überprüft, wenn die Seite serialisiert wird.
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 |