COleControl::GetDC

Fournit un objet sans fenêtre pour obtenir un contexte de périphérique d'écran (ou compatibles) de son conteneur.

CDC* GetDC(
   LPCRECT lprcRect = NULL,
   DWORD dwFlags = OLEDC_PAINTBKGND 
);

Paramètres

  • lprcRect
    Pointeur vers le rectangle que le contrôle sans fenêtre souhaite redessiner, dans les coordonnées clientes du contrôle.NULL signifie l'étendue complète de l'objet.

  • dwFlags
    Attributs de dessin du contexte de périphérique.Les choix sont :

    • OLEDC_NODRAW indique que l'objet n'utilisera pas le contexte de périphérique pour n'effectuer aucun dessin mais seulement pour obtenir des informations sur le périphérique d'affichage.Le conteneur doit simplement passer le contrôleur de domaine de la fenêtre sans traitement davantage.

    • Demandes d'OLEDC_PAINTBKGND que la peinture de conteneur l'arrière-plan avant de retourner le contrôleur de domaine.Un objet doit utiliser cet indicateur s'il demande un contrôleur de domaine pour redessiner une zone avec un arrière-plan transparent.

    • OLEDC_OFFSCREEN informe le conteneur que l'objet doit s'afficher dans une bitmap hors écran qui doit être copié à l'écran.Un objet doit utiliser cet indicateur lorsque l'opération de dessin qu'il est sur le point d'exécution génère plusieurs scintillement.Le conteneur est libre de honorer cette demande ou pas.Toutefois, si cette balise n'est pas définie, le conteneur doit réinitialiser d'un contrôleur de domaine affichée à l'écran.Cela permet à des objets pour exécuter des opérations directes d'écran comme afficher une sélection (via une opération de XOR ).

Valeur de retour

Pointeur vers le contexte de périphérique d'affichage de la zone cliente d' CWnd de conteneur si l'opération a réussi ; sinon, la valeur de retour est NULL.Le contexte de périphérique d'affichage peut être utilisé dans les fonctions suivantes GDI pour dessiner dans la zone cliente de la fenêtre du conteneur.

Notes

La fonction membre de ReleaseDC doit être appelée pour libérer le contexte après qu'il a.En appelant GetDC, les objets passent le rectangle qu'ils souhaitent pour dessiner dans dans leurs propres coordonnées clientes.GetDC traduit -les aux coordonnées de la zone cliente du conteneur.L'objet ne doit pas demander un rectangle de dessin souhaité plus grand que son propre rectangle de zone cliente, la taille dont peut être récupéré avec GetClientRect.Cela empêché des objets de dessiner par inadvertance où ils ne sont pas supposés.

Configuration requise

Header: afxctl.h

Voir aussi

Référence

Classe de COleControl

Graphique de la hiérarchie

COleControl::ReleaseDC