ID2D1PrintControl::AddPage-Methode (d2d1_1.h)

Artikel
05/30/2024

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

Freigeben über