CWnd::GetDCEx

Article
03/04/2013

Récupère le handle d'un contexte de périphérique pour la fenêtre d' CWnd .

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

Paramètres

prgnClip
Identifie une zone de découpage qui peut être combinées avec la région visible de la fenêtre cliente.
flags
Peut avoir l'une des valeurs prédéfinies suivantes :
- DCX_CACHE retourne un contexte de périphérique du cache au lieu de la fenêtre d' OWNDC ou de CLASSDC .Substitutions CS_OWNDC et CS_CLASSDC.
- DCX_CLIPCHILDREN exclut les régions visibles de toutes les fenêtres enfants au-dessous de la fenêtre d' CWnd .
- DCX_CLIPSIBLINGS exclut les régions visibles de toutes les fenêtres sœurs au-dessus de la fenêtre d' CWnd .
- DCX_EXCLUDERGN exclut la région de découpage identifiée par prgnClip de la région visible du contexte retourné de périphérique.
- DCX_INTERSECTRGN croise la région de découpage identifiée par prgnClip dans la région visible du contexte retourné de périphérique.
- DCX_LOCKWINDOWUPDATE permet le dessin même s'il existe un appel d' LockWindowUpdate en effet qui exclurait sinon cette fenêtre.Cette valeur est utilisée pour dessiner pendant le suivi.
- DCX_PARENTCLIP utilise la région visible de la fenêtre parente et ignore les bits de style parents de WS_CLIPCHILDREN et de WS_PARENTDC de la fenêtre.Cette valeur définit l'origine du contexte de périphérique à l'angle supérieur gauche de la fenêtre d' CWnd .
- DCX_WINDOW retourne un contexte de périphérique qui correspond au rectangle de fenêtre et non dans le rectangle client.

Valeur de retour

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

Notes

Le contexte de périphérique peut être utilisé dans les fonctions suivantes GDI pour dessiner dans la zone cliente.

Cette fonction, qui est une extension à la fonction de GetDC , donne à une application de mieux contrôler la façon dont et de si un contexte de périphérique pour une fenêtre est découpé.

À moins que le contexte de périphérique appartienne à une classe de fenêtre, la fonction de ReleaseDC doit être appelée pour libérer le contexte de dessin.Étant donné que cinq contextes courants de périphérique sont disponibles à un moment donné, le manque de libérer un contexte de périphérique peut empêcher d'autres applications d'accéder à un contexte de périphérique.

Pour obtenir un contexte mis en cache du périphérique, une application doit spécifier DCX_CACHE.Si DCX_CACHE n'est pas spécifié et la fenêtre n'est ni CS_OWNDC ni CS_CLASSDC, retourne NULLde cette fonction.

Un contexte de périphérique avec des fonctionnalités spéciales est retourné par la fonction de GetDCEx si le style de CS_CLASSDC, de CS_OWNDC, ou de CS_PARENTDC a été spécifié dans la structure de WNDCLASS lorsque la classe a été signalée.

Pour plus d'informations sur ces fonctionnalités, consultez la description de la structure de WNDCLASS dans Kit de développement logiciel Windows.