Condividi tramite


Funzione GetDCEx (winuser.h)

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

Vedi anche

Beginpaint

Funzioni del contesto del dispositivo

Panoramica dei contesti del dispositivo

GetWindowDC

ReleaseDC

WNDCLASS