CW&nd::GetDCExnbsp;

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

Valeur de retour

Le contexte de périphérique de la fenêtre spécifiée si la fonction a réussi ; sinon NULL.

Paramètres

prgnClip

Identifie une zone de découpage peut-être être combinés avec la région visible de la fenêtre client.

drapeaux

Peut avoir l'une des valeurs prédéfinies suivantes:

• DCX_CACHEnbsp ;  Retourne un contexte de périphérique à partir du cache plutôt que de la fenêtre OW&NDC ou CLASSDC . Substitue CS_OWNDC et CS_CLASSDC.
  
  
• DCX_CLIPCHILDRE&Nnbsp ;  Exclut les régions visibles de toutes les fenêtres enfants au-dessous de la fenêtre de CWnd.
  
  
• DCX_CLIPSIBLI&NGSnbsp ;  Exclut les régions visibles de toutes les fenêtres de frère au-dessus de la fenêtre de CWnd.
  
  
• DCX_EXCLUDERG&Nnbsp ;  Exclut la zone de découpage identifiée par prgnClip de la région visible du contexte de périphérique retourné.
  
  
• DCX_I&NTERSECTRGNnbsp ;  Coupe de la région de détourage identifiée par prgnClip dans la région visible du contexte de périphérique retourné.
  
  
• DCX_LOCKWI&NDOWUPDATEnbsp ;  Permet de dessiner même si il y a un LockWindowUpdate appellent en effet qui exclurait autrement cette fenêtre. Cette valeur est utilisée pour le dessin au cours du suivi.
  
  
• DCX_PARE&NTCLIPnbsp ;  Utilise la région visible de la fenêtre parent et ne tient pas compte des bits de style WS_CLIPCHILDREN et WS_PARENTDC de la fenêtre parente. Cette valeur définit l'origine du contexte de périphérique à l'angle supérieur gauche de la fenêtre de CWnd.
  
  
• DCX_WI&NDOWnbsp ;  Retourne un contexte de périphérique qui correspond au rectangle de la fenêtre plutôt que le rectangle client.

Remarques

Récupère le handle d'un contexte de périphérique de la fenêtre de CWnd . Le contexte de périphérique peut être utilisé dans les fonctions GDI pour dessiner dans la zone client.

Cette fonction, qui est une extension de la fonction GetDC , fournit à une application plus de contrôle sur la question de savoir si et comment un contexte de périphérique d'une fenêtre est tronqué.

À moins que le contexte de périphérique appartient à une classe de fenêtre, la fonction ReleaseDC doit être appelée pour libérer le contexte d'après dessin. Puisque seulement cinq contextes de périphérique courants sont disponibles à tout moment, défaut de libérer un contexte de périphérique peut empêcher les autres applications d'accéder à un contexte de périphérique.

Afin d'obtenir un contexte de périphérique mis en cache, une application doit spécifier DCX_CACHE. Si DCX_CACHE n'est pas spécifié et si la fenêtre n'est ni CS_OWNDC ni CS_CLASSDC, cette fonction renvoie la valeur NULL.

Un contexte de périphérique avec des caractéristiques particulières est retourné par la GetDCEx fonctionner si l' CS_CLASSDC, CS_OWNDC, ou style CS_PARENTDC a été spécifié dans le structure WNDCLASS lorsque la classe a été enregistrée.

Pour plus d'informations sur ces caractéristiques, consultez la description de la structure WNDCLASS dans la documentation du SDK Win32.

Aperçu de CWnd |nbsp ; Membres de la classe | Graphique de la hiérarchie

Voir aussinbsp ;CWnd::BeginPaint, CWnd::GetDC, CWnd::GetWindowDC, CWnd::ReleaseDC, :: GetDCEx