Share via

ID2D1Device::CreatePrintControl(IWICImagingFactory*,IPrintDocumentPackageTarget*,constD2D1_PRINT_CONTROL_PROPERTIES*,ID2D1PrintControl**)-Methode (d2d1_1.h)

  • Artikel

Erstellt ein ID2D1PrintControl-Objekt , das direct2D-Grundtypen , die in ID2D1CommandList gespeichert sind, in eine feste Seitendarstellung konvertiert. Das Druckuntersystem nutzt dann die Grundtypen.

Syntax

HRESULT CreatePrintControl(
  [in]           IWICImagingFactory                  *wicFactory,
  [in]           IPrintDocumentPackageTarget         *documentTarget,
  [in, optional] const D2D1_PRINT_CONTROL_PROPERTIES *printControlProperties,
  [out]          ID2D1PrintControl                   **printControl
);

Parameter

[in] wicFactory

Typ: IWICImagingFactory*

Eine WIC-Imagingfactory.

[in] documentTarget

Typ: IPrintDocumentPackageTarget*

Der Zieldruckauftrag für dieses Steuerelement.

[in, optional] printControlProperties

Typ: const D2D1_PRINT_CONTROL_PROPERTIES*

Die Optionen, die auf das Drucksteuerelement angewendet werden sollen.

[out] printControl

Typ: ID2D1PrintControl**

Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf ein ID2D1PrintControl-Objekt .

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_FAIL Generischer Fehlercode.
D2DERR_PRINT_FORMAT_NOT_SUPPORTED Das Druckformat wird vom Dokumentziel nicht unterstützt.

Hinweise

Hinweis Dies ist eine blockierende oder synchrone Funktion, die möglicherweise nicht sofort zurückgegeben wird. Wie schnell diese Funktion zurückgibt, hängt von Laufzeitfaktoren wie Netzwerk-status, Druckerserverkonfiguration und Druckertreiberimplementierung ab– Faktoren, die beim Schreiben einer Anwendung schwer vorherzusagen sind. Das Aufrufen dieser Funktion aus einem Thread, der die Interaktion mit der Benutzeroberfläche verwaltet, könnte dazu führen, dass die Anwendung nicht mehr reagiert.
 

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
DLL D2d1.dll

Weitere Informationen

ID2D1Geräte