CClientDC::CClientDC

[アーティクル]
08/09/2011

pWnd で指定される CWnd のクライアント領域にアクセスする CClientDC オブジェクトを構築します。

explicit CClientDC(
   CWnd* pWnd 
);

パラメーター

pWnd
デバイスコンテキストオブジェクトがアクセスするクライアント領域を持つウィンドウ。

解説

コンストラクターは、Windows の GetDC 関数を呼び出します。

Windows の GetDC 関数の呼び出しが失敗すると、CResourceException 型の例外がスローされます。 Windows が利用できるすべてのデバイスコンテキストを既に割り当ててしまっているときは、デバイスコンテキストは利用できません。アプリケーションは、Windows でいつでも使用できる 5 つの共通ディスプレイコンテキストを競争して取得します。

使用例

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

   CClientDC clientDC(this);

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