CClientDC-Klasse

  • Artikel

Kümmert sich um das Aufrufen der Windows-Funktionen GetDC zur Bauzeit und ReleaseDC zur Zerstörungszeit.

Syntax

class CClientDC : public CDC

Member

Öffentliche Konstruktoren

Name Beschreibung
CClientDC::CClientDC Erstellt ein CClientDC objekt, das mit der CWnd.

Geschützte Datenmember

Name Beschreibung
CClientDC::m_hWnd Der HWND des Fensters, für das dies CClientDC gültig ist.

Hinweise

Dies bedeutet, dass der einem Objekt zugeordnete CClientDC Gerätekontext der Clientbereich eines Fensters ist.

Weitere Informationen CClientDCfinden Sie unter "Gerätekontexte".

Vererbungshierarchie

CObject

CDC

CClientDC

Anforderungen

Header: afxwin.h

CClientDC::CClientDC

Erstellt ein CClientDC Objekt, das auf den Clientbereich des CWnd zugreift, auf das von pWnd verwiesen wird.

explicit CClientDC(CWnd* pWnd);

Parameter

pWnd
Das Fenster, auf dessen Clientbereich das Gerätekontextobjekt zugreift.

Hinweise

Der Konstruktor ruft die Windows-Funktion GetDC auf.

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

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

Der HWND Zeiger, der CWnd zum Erstellen des CClientDC Objekts verwendet wird.

HWND m_hWnd;

Hinweise

m_hWnd ist eine geschützte Variable.

Beispiel

Sehen Sie sich das Beispiel für CClientDC::CClientDC an.

Siehe auch

MFC-Beispiel-MDI
CDC-Klasse
Hierarchiediagramm
CDC-Klasse