GetDC-Funktion (winuser.h)

Artikel
08/27/2023

Die GetDC-Funktion ruft ein Handle für einen Gerätekontext (DC) für den Clientbereich eines angegebenen Fensters oder für den gesamten Bildschirm ab. Sie können den zurückgegebenen Handle in nachfolgenden GDI-Funktionen verwenden, um im DC zu zeichnen. Der Gerätekontext ist eine undurchsichtige Datenstruktur, deren Werte intern von GDI verwendet werden.

Die GetDCEx-Funktion ist eine Erweiterung von GetDC, die einer Anwendung mehr Kontrolle darüber gibt, wie und ob das Abschneiden im Clientbereich erfolgt.

Syntax

HDC GetDC(
  [in] HWND hWnd
);

Parameter

[in] hWnd

Ein Handle für das Fenster, dessen DC abgerufen werden soll. Wenn dieser Wert NULL ist, ruft GetDC den DC für den gesamten Bildschirm ab.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für den DC für den Clientbereich des angegebenen Fensters.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL.

Hinweise

Die GetDC-Funktion ruft je nach Klassenstil des angegebenen Fensters einen allgemeinen, eine Klasse oder einen privaten DC ab. Für Klassen- und private DCs lässt GetDC die zuvor zugewiesenen Attribute unverändert. Für gängige DCs weist GetDC dem DC jedoch bei jedem Abruf Standardattribute zu. Die Standardschriftart ist beispielsweise System, bei der es sich um eine Bitmapschriftart handelt. Aus diesem Zweck gibt das Handle für einen allgemeinen DC, der von GetDC zurückgegeben wird, nicht an, welche Schriftart, Farbe oder welcher Pinsel beim Zeichnen des Fensters verwendet wurde. Rufen Sie GetTextFace auf, um die Schriftart zu bestimmen.

Beachten Sie, dass das Handle zum DC nur von einem einzelnen Thread gleichzeitig verwendet werden kann.

Nach dem Zeichnen mit einem gemeinsamen DC muss die ReleaseDC-Funktion aufgerufen werden, um den DC freizugeben. Klassen- und private DCs müssen nicht freigegeben werden. ReleaseDC muss aus demselben Thread aufgerufen werden, der GetDC genannt hat. Die Anzahl der DCs ist nur durch den verfügbaren Arbeitsspeicher begrenzt.

Beispiele

Ein Beispiel finden Sie unter Zeichnen mit der Maus.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll