CW&nd::GetDCExnbsp;

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

Valore restituito

Il contesto di periferica per la finestra specificata, se la funzione ha esito positivo; in caso contrario NULL.

Parametri

prgnClip

Identifica un'area di ritaglio può essere combinata con l'area visibile della finestra del client.

bandiere

Può avere uno dei seguenti valori preimpostati:

• DCX_CACHEnbsp;  Restituisce un contesto di periferica dalla cache anziché la finestra OW&NDC o CLASSDC . Esegue l'override di CS_OWNDC e CS_CLASSDC.
  
  
• DCX_CLIPCHILDRE&Nnbsp;  Sono escluse le regioni visibile di tutte le finestre figlio sotto la finestra CWnd.
  
  
• DCX_CLIPSIBLI&NGSnbsp;  Sono escluse le regioni visibile di tutte le finestre di pari livello sopra la finestra di CWnd.
  
  
• DCX_EXCLUDERG&Nnbsp;  Esclude l'area di ritaglio identificato da prgnClip dall'area visibile del contesto di periferica restituito.
  
  
• DCX_I&NTERSECTRGNnbsp;  Interseca l'area di ritaglio identificato da prgnClip nell'area visibile del contesto di periferica restituito.
  
  
• DCX_LOCKWI&NDOWUPDATEnbsp;  Permette di disegnare anche se c'è un LockWindowUpdate chiamare in vigore che escluderebbe altrimenti questa finestra. Questo valore è utilizzato per il disegno durante il rilevamento.
  
  
• DCX_PARE&NTCLIPnbsp;  Utilizza l'area visibile del finestra padre e ignora il bit di stile WS_CLIPCHILDREN e WS_PARENTDC della finestra padre. Questo valore imposta l'origine del contesto della periferica per l'angolo superiore sinistro della finestra di CWnd.
  
  
• DCX_WI&NDOWnbsp;  Restituisce un contesto di periferica che corrisponde al rettangolo finestra anziché il rettangolo client.

Osservazioni

Recupera l'handle di un contesto di periferica per la finestra di CWnd . Il contesto di periferica può essere utilizzato in successive funzioni GDI per disegnare nell'area client.

Questa funzione, che è un'estensione per il funzione GetDC , dà un'applicazione più controllo sul come e se viene ritagliato un contesto di periferica per una finestra.

A meno che il contesto di periferica appartiene a una classe di finestra, il ReleaseDC funzione deve essere chiamata per rilasciare il contesto dopo disegno. Dal momento che solo cinque contesti di periferica comuni sono disponibili in un dato momento, il mancato rilascio di un contesto di periferica può prevenire altre applicazioni di accedere a un contesto di periferica.

Al fine di ottenere un contesto di periferica memorizzata nella cache, un'applicazione deve specificare DCX_CACHE. Se DCX_CACHE non è specificato e la finestra è né CS_OWNDC né CS_CLASSDC, questa funzione restituisce NULL.

Restituito da un contesto di periferica con caratteristiche speciali del GetDCEx funzionare se CS_CLASSDC, CS_OWNDC, o CS_PARENTDC stile specificato nella struttura WNDCLASS quando la classe è stata registrata.

Per ulteriori informazioni su queste caratteristiche, vedere la descrizione della struttura WNDCLASS nella documentazione SDK Win32.

Panoramica di CWnd |nbsp; Membri della classe | Gerarchia Chart

Vedere anchenbsp;CWnd::BeginPaint, CWnd::GetDC, CWnd::GetWindowDC, CWnd::ReleaseDC, :: GetDCEx