CWnd::GetDCEx

Recupera l'handle di un contesto di dispositivo per la finestra CWnd.

CDC* GetDCEx(
   CRgn* prgnClip,
   DWORD flags 
);

Parametri

  • prgnClip
    Identifica un'area di ritaglio che può essere combinato con l'area visibile della finestra client.

  • flags
    Può essere uno dei seguenti valori preimpostati:

    • DCX_CACHE restituisce un contesto di dispositivo dalla cache anziché la finestra CLASSDC o OWNDC.Override CS_OWNDC e CS_CLASSDC.

    • DCX_CLIPCHILDREN esclude le aree visibili di tutte le finestre figlio della finestra CWnd.

    • DCX_CLIPSIBLINGS esclude le aree visibili di tutte le finestre di pari livello nella finestra CWnd.

    • DCX_EXCLUDERGN esclude l'area di ridimensionamento identificata da prgnClip dall'area visibile del contesto di dispositivo restituito.

    • DCX_INTERSECTRGN interseca l'area di ridimensionamento identificata da prgnClip nell'area visibile del contesto di dispositivo restituito.

    • DCX_LOCKWINDOWUPDATE consente il disegno anche se esiste una chiamata LockWindowUpdate in effetti che esclude in questa finestra.Questo valore viene utilizzato per disegnare durante la verifica.

    • DCX_PARENTCLIP utilizza l'area visibile della finestra padre e ignora i bit di stile WS_CLIPCHILDREN e WS_PARENTDC della finestra padre.Questo set di valori l'origine del contesto di dispositivoangolo superiore sinistro della finestra CWnd.

    • DCX_WINDOW restituisce un contesto di dispositivo che corrisponde al rettangolo della finestra anziché il rettangolo client.

Valore restituito

Il contesto di dispositivo per una finestra specifica se la funzione ha esito positivo; in caso contrario NULL.

Note

Il contesto di dispositivo può essere utilizzato nelle funzioni chiamate successive GDI per disegnare l'area client.

Questa funzione, che è un'estensione alla funzione GetDC, fornisce a un'applicazione un controllo maggiore su e se un contesto di dispositivo per una finestra viene tagliato.

A meno che il contesto di dispositivo appartiene a una classe finestra, la funzione ReleaseDC deve essere chiamata per bloccare il contesto dopo avere creato.Poiché solo cinque contesti di periferica comuni sono disponibili in un determinato momento, l'omissione di eliminare un contesto di dispositivo può impedire altre applicazioni di accedere a un contesto di dispositivo.

Per ottenere un contesto di dispositivo memorizzato nella cache, un'applicazione deve specificare DCX_CACHE.Se DCX_CACHE non viene specificato e la finestra non è CS_OWNDCCS_CLASSDC, restituisce NULLdella funzione.

Un contesto di dispositivo con le caratteristiche speciali viene restituito dalla funzione GetDCEx se lo stile CS_CLASSDC, CS_OWNDC, o CS_PARENTDC è stato specificato nella struttura WNDCLASS quando la classe registrata.

Per ulteriori informazioni su queste funzionalità, vedere la descrizione della struttura WNDCLASS in Windows SDK.

Requisiti

Header: afxwin.h

Vedere anche

Riferimenti

Classe CWnd

Grafico della gerarchia

CWnd::BeginPaint

CWnd::GetDC

CWnd::GetWindowDC

CWnd::ReleaseDC

GetDCEx