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 |