Funzione GetWindowDC (winuser.h)

Articolo
03/04/2024

La funzione GetWindowDC recupera il contesto di dispositivo (DC) per l'intera finestra, inclusa la barra del titolo, i menu e le barre di scorrimento. Un contesto di dispositivo finestra consente di disegnare ovunque in una finestra, perché l'origine del contesto di dispositivo è l'angolo superiore sinistro della finestra anziché l'area client.

GetWindowDC assegna gli attributi predefiniti al contesto del dispositivo della finestra ogni volta che recupera il contesto del dispositivo. Gli attributi precedenti vengono persi.

Sintassi

HDC GetWindowDC(
  [in] HWND hWnd
);

Parametri

[in] hWnd

Handle per la finestra con un contesto di dispositivo da recuperare. Se questo valore è NULL, GetWindowDC recupera il contesto del dispositivo per l'intera schermata.

Se questo parametro è NULL, GetWindowDC recupera il contesto di dispositivo per il monitoraggio dello schermo primario. Per ottenere il contesto del dispositivo per altri monitoraggi di visualizzazione, usare le funzioni EnumDisplayMonitors e CreateDC .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle per un contesto di dispositivo per la finestra specificata.

Se la funzione ha esito negativo, il valore restituito è NULL, che indica un errore o un parametro hWnd non valido.

Commenti

GetWindowDC è destinato a effetti di disegno speciali all'interno dell'area non client di una finestra. La pittura in aree non client di qualsiasi finestra non è consigliata.

La funzione GetSystemMetrics può essere utilizzata per recuperare le dimensioni di varie parti dell'area non client, ad esempio la barra del titolo, il menu e le barre di scorrimento.

La funzione GetDC può essere usata per recuperare un contesto di dispositivo per l'intera schermata.

Al termine del disegno, è necessario chiamare la funzione ReleaseDC per rilasciare il contesto di dispositivo. Il mancato rilascio del contesto del dispositivo finestra ha effetti gravi sulla pittura richiesta dalle applicazioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-draw-l1-1-0 (introdotto in Windows 8)