cpaintdc-class.md

title	ms.custom	ms.date	ms.reviewer	ms.suite	ms.technology	ms.tgt_pltfrm	ms.topic	f1_keywords	dev_langs	helpviewer_keywords	ms.assetid	caps.latest.revision	author	ms.author	manager
CPaintDC Class | Microsoft Docs		11/04/2016			cpp-windows		reference	CPaintDC AFXWIN/CPaintDC AFXWIN/CPaintDC::CPaintDC AFXWIN/CPaintDC::m_ps AFXWIN/CPaintDC::m_hWnd	C++	CPaintDC [MFC], CPaintDC CPaintDC [MFC], m_ps CPaintDC [MFC], m_hWnd	7e245baa-bf9b-403e-a637-7218adf28fab	22	mikeblome	mblome	ghogen

CPaintDC Class

A device-context class derived from CDC.

Syntax

class CPaintDC : public CDC  

Members

Public Constructors

Name	Description
CPaintDC::CPaintDC	Constructs a CPaintDC connected to the specified CWnd.

Public Data Members

Name	Description
CPaintDC::m_ps	Contains the PAINTSTRUCT used to paint the client area.

Protected Data Members

Name	Description
CPaintDC::m_hWnd	The HWND to which this CPaintDC object is attached.

Remarks

It performs a CWnd::BeginPaint at construction time and CWnd::EndPaint at destruction time.

A CPaintDC object can only be used when responding to a WM_PAINT message, usually in your OnPaint message-handler member function.

For more information on using CPaintDC, see Device Contexts.

Inheritance Hierarchy

CObject

CDC

CPaintDC

Requirements

Header: afxwin.h

CPaintDC::CPaintDC

Constructs a CPaintDC object, prepares the application window for painting, and stores the PAINTSTRUCT structure in the m_ps member variable.

explicit CPaintDC(CWnd* pWnd);

Parameters

pWnd
Points to the CWnd object to which the CPaintDC object belongs.

Remarks

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

[!code-cppNVC_MFCDocView#97]

CPaintDC::m_hWnd

The HWND to which this CPaintDC object is attached.

HWND m_hWnd;  

Remarks

m_hWnd is a protected variable of type HWND.

Example

[!code-cppNVC_MFCDocView#98]

CPaintDC::m_ps

m_ps is a public member variable of type PAINTSTRUCT.

PAINTSTRUCT m_ps;  

Remarks

It is the PAINTSTRUCT that is passed to and filled out by CWnd::BeginPaint.

The PAINTSTRUCT contains information that the application uses to paint the client area of the window associated with a CPaintDC object.

Note that you can access the device-context handle through the PAINTSTRUCT. However, you can access the handle more directly through the m_hDC member variable that CPaintDC inherits from CDC.

Example

See the example for CPaintDC::m_hWnd.

See Also

MFC Sample MDI
CDC Class
Hierarchy Chart