GetWindowDC-Funktion (winuser.h)

Artikel
03/06/2024

Die GetWindowDC-Funktion ruft den Gerätekontext (Device Context, DC) für das gesamte Fenster ab, einschließlich Titelleiste, Menüs und Bildlaufleisten. Ein Fenstergerätekontext ermöglicht das Zeichnen an einer beliebigen Stelle in einem Fenster, da der Ursprung des Gerätekontexts in der oberen linken Ecke des Fensters und nicht im Clientbereich liegt.

GetWindowDC weist dem Fenstergerätekontext bei jedem Abrufen des Gerätekontexts Standardattribute zu. Vorherige Attribute gehen verloren.

Syntax

HDC GetWindowDC(
  [in] HWND hWnd
);

Parameter

[in] hWnd

Ein Handle für das Fenster mit einem Gerätekontext, der abgerufen werden soll. Wenn dieser Wert NULL ist, ruft GetWindowDC den Gerätekontext für den gesamten Bildschirm ab.

Wenn dieser Parameter NULL ist, ruft GetWindowDC den Gerätekontext für den primären Anzeigemonitor ab. Verwenden Sie zum Abrufen des Gerätekontexts für andere Anzeigemonitore die Funktionen EnumDisplayMonitors und CreateDC .

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für einen Gerätekontext für das angegebene Fenster.

Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL, was einen Fehler oder einen ungültigen hWnd-Parameter angibt.

Hinweise

GetWindowDC ist für spezielle Maleffekte im Nichtclientbereich eines Fensters vorgesehen. Das Zeichnen in Nichtclientbereichen eines Fensters wird nicht empfohlen.

Die GetSystemMetrics-Funktion kann verwendet werden, um die Dimensionen verschiedener Teile des Nichtclientbereichs abzurufen, z. B. Titelleiste, Menü und Bildlaufleisten.

Die GetDC-Funktion kann verwendet werden, um einen Gerätekontext für den gesamten Bildschirm abzurufen.

Nachdem das Zeichnen abgeschlossen ist, muss die ReleaseDC-Funktion aufgerufen werden, um den Gerätekontext freizugeben. Das Nicht freigeben des Fenstergerätekontexts hat schwerwiegende Auswirkungen auf die von Anwendungen angeforderte Zeichnung.

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 (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-draw-l1-1-0 (eingeführt in Windows 8)