GetWindowDC-Funktion (winuser.h)
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) |