Freigeben über

CPaintDC-Klasse

  • Artikel

Eine gerätekontextbezogene Klasse, die von CDC.

Syntax

class CPaintDC : public CDC

Member

Öffentliche Konstruktoren

Name Beschreibung
CPaintDC::CPaintDC Erstellt eine CPaintDC Verbindung mit dem angegebenen CWnd.

Öffentliche Datenmember

Name Beschreibung
CPaintDC::m_ps Enthält die PAINTSTRUCT zum Zeichnen des Clientbereichs verwendete Datei.

Geschützte Datenmember

Name Beschreibung
CPaintDC::m_hWnd Das HWND Objekt, an das dieses CPaintDC Objekt angefügt ist.

Hinweise

Es führt CWnd::BeginPaint zur Bauzeit und CWnd::EndPaint zur Zerstörungszeit durch.

Ein CPaintDC Objekt kann nur verwendet werden, wenn er auf eine WM_PAINT Nachricht antwortet, in der Regel in der Memberfunktion des OnPaint Nachrichtenhandlers.

Weitere Informationen zur Verwendung CPaintDCfinden Sie unter "Gerätekontexte".

Vererbungshierarchie

CObject

CDC

CPaintDC

Anforderungen

Header: afxwin.h

CPaintDC::CPaintDC

Erstellt ein CPaintDC Objekt, bereitet das Anwendungsfenster für das Zeichnen vor und speichert die PAINTSTRUCT Struktur in der m_ps Membervariable.

explicit CPaintDC(CWnd* pWnd);

Parameter

pWnd
Verweist auf das CWnd Objekt, zu dem das CPaintDC Objekt gehört.

Hinweise

Eine Ausnahme (vom Typ CResourceException) wird ausgelöst, wenn der Windows-Aufruf GetDC fehlschlägt. Ein Gerätekontext ist möglicherweise nicht verfügbar, wenn Windows bereits alle verfügbaren Gerätekontexte zugewiesen hat. Ihre Anwendung konkurriert für die fünf gängigen Anzeigekontexte, die zu einem bestimmten Zeitpunkt unter Windows verfügbar sind.

Beispiel

// Get a dc for a CWnd pointer.
CPaintDC dc(pWnd);

// Get a dc for a HWND.
CPaintDC dc2(CWnd::FromHandle(hWnd));

CPaintDC::m_hWnd

Das HWND Objekt, an das dieses CPaintDC Objekt angefügt ist.

HWND m_hWnd;

Hinweise

m_hWnd ist eine geschützte Variable vom Typ HWND.

Beispiel

// Get a dc for a CWnd object pointer.
CPaintDC dc(pWnd);

// Send my private message.
::SendMessage(pWnd->m_hWnd, WM_MYMESSAGE, (LPARAM)& dc.m_ps, 0);

CPaintDC::m_ps

m_ps ist eine öffentliche Membervariable vom Typ PAINTSTRUCT.

PAINTSTRUCT m_ps;

Hinweise

Es ist dasPAINTSTRUCT, das an und ausgefüllt wird.CWnd::BeginPaint

Die PAINTSTRUCT enthält Informationen, die von der Anwendung zum Zeichnen des Clientbereichs des Fensters verwendet werden, das einem CPaintDC Objekt zugeordnet ist.

Beachten Sie, dass Sie über die PAINTSTRUCT. Sie können jedoch direkt über die m_hDC Membervariable, die von CDC erbt, CPaintDC auf das Handle zugreifen.

Beispiel

Ein Beispiel hierfür finden Sie unter CPaintDC::m_hWnd.

Siehe auch

MFC-Beispiel-MDI
CDC Klasse
Hierarchiediagramm