Partager via


CClientDC, classe

Prend soin d’appeler les fonctions Windows GetDC au moment de la construction et ReleaseDC au moment de la destruction.

Syntaxe

class CClientDC : public CDC

Membres

Constructeurs publics

Nom Description
CClientDC ::CClientDC Construit un CClientDC objet connecté au CWnd.

Membres de données protégés

Nom Description
CClientDC ::m_hWnd HWND de la fenêtre pour laquelle cela CClientDC est valide.

Notes

Cela signifie que le contexte d’appareil associé à un CClientDC objet est la zone cliente d’une fenêtre.

Pour plus d’informations sur CClientDC, consultez Contextes de l’appareil.

Hiérarchie d'héritage

CObject

CDC

CClientDC

Spécifications

En-tête : afxwin.h

CClientDC ::CClientDC

Construit un CClientDC objet qui accède à la zone cliente du CWnd pointé par pWnd.

explicit CClientDC(CWnd* pWnd);

Paramètres

pWnd
Fenêtre dont la zone cliente accède à l’objet de contexte de l’appareil.

Notes

Le constructeur appelle la fonction Windows GetDC.

Une exception (de type CResourceException) est levée si l’appel Windows GetDC échoue. Un contexte d’appareil peut ne pas être disponible si Windows a déjà alloué tous ses contextes d’appareil disponibles. Votre application concurrence les cinq contextes d’affichage courants disponibles à tout moment sous Windows.

Exemple

void CDCView::DrawInClientDC(CDC *pDC)
{
   UNREFERENCED_PARAMETER(pDC);
   CClientDC clientDC(this);
   clientDC.TextOut(10, 10, CString(_T("I used a client DC!")));
}

CClientDC ::m_hWnd

Pointeur HWND utilisé pour construire l’objetCClientDC.CWnd

HWND m_hWnd;

Notes

m_hWnd est une variable protégée.

Exemple

Consultez l’exemple de CClientDC ::CClientDC.

Voir aussi

Exemple MFC MDI
CDC, classe
Graphique hiérarchique
CDC, classe