Funzione GetDCEx (winuser.h)

Articolo
03/09/2024

La funzione GetDCEx 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.

Questa funzione è un'estensione per la funzione GetDC , che fornisce un maggiore controllo dell'applicazione su come e se il ritaglio si verifica nell'area client.

Sintassi

HDC GetDCEx(
  [in] HWND  hWnd,
  [in] HRGN  hrgnClip,
  [in] DWORD flags
);

Parametri

[in] hWnd

Handle nella finestra di cui recuperare il controller di dominio. Se questo valore è NULL, GetDCEx recupera il controller di dominio per l'intera schermata.

[in] hrgnClip

Area di ritaglio che può essere combinata con l'area visibile del controller di dominio. Se il valore dei flag è DCX_INTERSECTRGN o DCX_EXCLUDERGN, il sistema operativo presuppone la proprietà dell'area e lo eliminerà automaticamente quando non è più necessario. In questo caso, l'applicazione non deve usare o eliminare l'area dopo una chiamata riuscita a GetDCEx.

[in] flags

Specifica la modalità di creazione del controller di dominio. Questo parametro può essere uno o più dei valori seguenti.

Valore	Significato
DCX_WINDOW	Restituisce un controller di dominio corrispondente al rettangolo della finestra anziché al rettangolo client.
DCX_CACHE	Restituisce un controller di dominio dalla cache anziché dalla finestra OWNDC o CLASSDC. Essenzialmente esegue l'override di CS_OWNDC e CS_CLASSDC.
DCX_PARENTCLIP	Usa l'area visibile della finestra padre. I bit di stile WS_CLIPCHILDREN e CS_PARENTDC padre vengono ignorati. L'origine è impostata sull'angolo superiore sinistro della finestra identificata da hWnd.
DCX_CLIPSIBLINGS	Esclude le aree visibili di tutte le finestre di pari livello sopra la finestra identificata da hWnd.
DCX_CLIPCHILDREN	Esclude le aree visibili di tutte le finestre figlio sotto la finestra identificata da hWnd.
DCX_NORESETATTRS	Questo flag viene ignorato.
DCX_LOCKWINDOWUPDATE	Consente il disegno anche se esiste una chiamata LockWindowUpdate in effetti che altrimenti escluderebbe questa finestra. Usato per il disegno durante il rilevamento.
DCX_EXCLUDERGN	L'area di ritaglio identificata da hrgnClip è esclusa dall'area visibile del controller di dominio restituito.
DCX_INTERSECTRGN	L'area di ritaglio identificata da hrgnClip viene intersecata con l'area visibile del controller di dominio restituito.
DCX_INTERSECTUPDATE	Riservati; non usare.
DCX_VALIDATE	Riservati; non usare.

Valore restituito

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

Se la funzione ha esito negativo, il valore restituito è NULL. Un valore non valido per il parametro hWnd causerà l'esito negativo della funzione.

Commenti

A meno che il controller di dominio visualizzato non appartenga a una classe di finestra, la funzione ReleaseDC deve essere chiamata per rilasciare il controller di dominio dopo la pittura. Inoltre, ReleaseDC deve essere chiamato dallo stesso thread denominato GetDCEx. Il numero di controller di dominio è limitato solo dalla memoria disponibile.

La funzione restituisce un handle a un controller di dominio appartenente alla classe della finestra se CS_CLASSDC, CS_OWNDC o CS_PARENTDC è stato specificato come stile nella struttura WNDCLASS quando la classe è stata registrata.

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