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, optional]  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 DIPs (1 Zoll == 96 DIP). Wenn der Drucktreiber nicht auf diesen Parameter reagiert, können Sie stattdessen pagePrintTicketStream verwenden.

[in, optional] pagePrintTicketStream

Typ: IStream*

Der Druckticketstream. Sie können dies verwenden, um die Eigenschaften der aktuellen Seite zu ändern. z. B. Papierformat oder Ausrichtung.

[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 Aufruf 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