ID2D1PrintControl::AddPage-Methode (d2d1_1.h)

Konvertiert Direct2D-Grundtypen in der übergebenen Befehlsliste in eine feste Seitendarstellung zur Verwendung durch das Drucksubsystem.

Syntax

HRESULT AddPage(
  [in]            ID2D1CommandList *commandList,
                  D2D_SIZE_F       pageSize,
  [in, out]       IStream          *pagePrintTicketStream,
  [out, optional] D2D1_TAG         *tag1,
  [out, optional] D2D1_TAG         *tag2
);

Parameter

[in] commandList

Typ: ID2D1CommandList*

Die Befehlsliste, die die Renderingvorgänge enthält.

pageSize

Typ: D2D_SIZE_F

Die Größe der hinzuzufügenden Seite.

[in, out] pagePrintTicketStream

Typ: IStream*

Der Druckticketstream.

[out, optional] tag1

Typ: D2D1_TAG*

Enthält die erste Bezeichnung für nachfolgende Zeichnungsvorgänge. Dieser Parameter wird nicht initialisiert übergeben. Wenn NULL angegeben ist, wird für diesen Parameter kein Wert abgerufen.

[out, optional] tag2

Typ: D2D1_TAG*

Enthält die zweite Bezeichnung für nachfolgende Zeichnungsvorgänge. Dieser Parameter wird nicht initialisiert übergeben. Wenn NULL angegeben ist, wird für diesen Parameter kein Wert abgerufen.

Rückgabewert

Typ: HRESULT

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

HRESULT	BESCHREIBUNG
S_OK	Kein Fehler ist aufgetreten.
E_OUTOFMEMORY	Direct2D konnte nicht genügend Arbeitsspeicher zuweisen, um den Anruf abzuschließen.
E_INVALIDARG	Ein ungültiger Parameter wurde an die zurückgebende Funktion übergeben.
D2DERR_PRINT_JOB_CLOSED	Der Druckauftrag ist bereits abgeschlossen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	d2d1_1.h
Bibliothek	D2d1.lib

Weitere Informationen

ID2D1PrintControl