Freigeben über


IXpsOMPage::SetBleedBox-Methode (xpsobjectmodel.h)

Legt die Abmessungen des Beschnittfelds der Seite fest.

Syntax

HRESULT SetBleedBox(
  [in] const XPS_RECT *bleedBox
);

Parameter

[in] bleedBox

Die Abmessungen des Beschnittfelds der Seite. Dieser Parameter darf nicht NULL sein.

Ein gültiges Beschnittfeld hat die folgenden Eigenschaften:

######## x)) ≤ Wert )

####### y)) ≤ Wert )

0)
0)

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliche Werte sind unter anderem diejenigen in der folgenden Tabelle. Informationen zu Rückgabewerten der XPS-Dokument-API, 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
bleedBox ist NULL.
XPS_E_INVALID_BLEED_BOX
Das durch bleedBox beschriebene Rechteck enthält einen oder mehrere ungültige Werte.

Hinweise

Die Beschnittfeldabmessungen werden erst dann anhand der Seitendimensionen überprüft, wenn die Seite serialisiert wird.

Anforderungen

   
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

IXpsOMPage

XML Paper Specification

XPS-Dokumentfehler

XPS_RECT