Die Community zu .NET und Classic VB.
Menü

CreateDC

 von 

Deklaration  

Declare Function CreateDC Lib "gdi32" _
                 Alias "CreateDCA" ( _
                 ByVal lpDriverName As String, _
                 ByVal lpDeviceName As String, _
                 ByVal lpOutput As String, _
                 ByVal lpInitData As Any) As Long
Weitere Informationen zur Verwendung dieser Funktion finden sie u.U. auch im Artikel CreateDC des API-Wikis.

CreateDC erzeugt einen Gerätekontext für das angegebene Gerät, wobei der vorgegebene Name verwendet wird. Im allgemeinen wird mit CreateDC ein Gerätekontext für einen Drucker erzeugt, aber es wird auch verwendet, um einen Gerätekontext für den Bildschirm zu erhalten (Dabei ist der Hardwarebilschirm gemeint, nicht der Clientbereich des Fensters). Diese Function sollte sorgfältig eingesetzt werden, weil sie einer Anwendung ermöglicht, an eine beliebige Stelle auf dem Bildschirm zu zeichnen, nicht nur innerhalb der Fensterbegrenzungen. Mit GetDC oder BeginPaint erhält man einen Gerätekontext für ein Fenster auf dem Bildschirm.

Parameter
lpDriverNameEin Zeiger auf einen Nullterminierten String, der den Dateinamen (ohne Erweiterung) des Gerätetreibers angibt. "DISPLAY" beispielsweise könnte sich auf einen Treiber für ein Anzeigegerät beziehen, "WINSPOOL" auf einen Druckertreiber.
lpDeviceNameEin Zeiger auf einen Nullterminierten String, der den Namen des spezifischen Ausgabegerätes angibt, wie im Druckmanager angezeigt (z.B. Beispiel "HP Laserjet").
lpOutputWird ignoriert, kann auf Null gesetzt werden. Wie Ausgaben einer Datei geschickt werden, finden Sie im Abschnitt für die Funktion StartDoc beschrieben.
lpInitDataEin Zeiger auf eine DEVMODE-Struktur, die gerätespezifische Initialisierungsdaten enthält, welche vom Anwender vorgegeben wurden (falls es solche gibt).

Tabelle 1


Rückgabewerte
LongDas Handle des DC für das angegebene Gerät, wenn die Funktion erfolgreich ausgeführt wurde.
0Es trat ein Fehler auf.

Tabelle 2


Unterstützte Betriebssysteme
Win32s, Windows 95, Windows 98, Windows NT

Verwandte API-Funktionen
DeleteDC, DocumentProperties, GetDC, BeginPaint, GetDeviceCaps

Zugehörige Tipps

Zugehörige Microsoft Knowledge Base Artikel