CClientDC::CClientDC

Constructs a CClientDC object that accesses the client area of the CWnd pointed to by pWnd.

explicit CClientDC(
   CWnd* pWnd 
);

Parameters

  • pWnd
    The window whose client area the device context object will access.

Remarks

The constructor calls the Windows function GetDC.

An exception (of type CResourceException) is thrown if the Windows GetDC call fails. A device context may not be available if Windows has already allocated all of its available device contexts. Your application competes for the five common display contexts available at any given time under Windows.

Example

void CDCView::DrawInClientDC(CDC* pDC)
{
   UNREFERENCED_PARAMETER(pDC);

   CClientDC clientDC(this);

   clientDC.TextOut(10, 10, CString(_T("I used a client DC!")));
}

Requirements

Header: afxwin.h

See Also

Reference

CClientDC Class

Hierarchy Chart

Other Resources

CClientDC Members