Funzione GetDC (winuser.h)

Articolo
03/15/2023

La funzione GetDC recupera un handle in un contesto di dispositivo (DC) per l'area client di una finestra specificata o per l'intera schermata. È possibile usare l'handle restituito nelle funzioni GDI successive per disegnare nel controller di dominio. Il contesto del dispositivo è una struttura di dati opaca, i cui valori vengono usati internamente da GDI.

La funzione GetDCEx è un'estensione di GetDC, che offre un'applicazione più controllo su come e se il ritaglio si verifica nell'area client.

Sintassi

HDC GetDC(
  [in] HWND hWnd
);

Parametri

[in] hWnd

Handle per la finestra il cui controller di dominio deve essere recuperato. Se questo valore è NULL, GetDC recupera il controller di dominio per l'intera schermata.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle per il controller di dominio per l'area client della finestra specificata.

Se la funzione ha esito negativo, il valore restituito è NULL.

Commenti

La funzione GetDC recupera un controller di dominio comune, classe o privato a seconda dello stile della classe della finestra specificata. Per le classi e i controller di dominio privati, GetDC lascia invariati gli attributi assegnati in precedenza. Tuttavia, per i controller di dominio comuni, GetDC assegna gli attributi predefiniti al controller di dominio ogni volta che viene recuperato. Ad esempio, il tipo di carattere predefinito è System, ovvero un tipo di carattere bitmap. Per questo motivo, l'handle di un controller di dominio comune restituito da GetDC non indica quale tipo di carattere, colore o pennello è stato usato quando è stata disegnata la finestra. Per determinare il tipo di carattere, chiamare GetTextFace.

Si noti che l'handle per il controller di dominio può essere usato solo da un singolo thread in qualsiasi momento.

Dopo aver eseguito il disegno con un controller di dominio comune, è necessario chiamare la funzione ReleaseDC per rilasciare il controller di dominio. Le classi e i controller di dominio privati non devono essere rilasciati. ReleaseDC deve essere chiamato dallo stesso thread denominato GetDC. Il numero di controller di dominio è limitato solo dalla memoria disponibile.

Esempio

Per un esempio, vedere Disegno con mouse.

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