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