次の方法で共有


CWnd::GetDCEx

CWnd のウィンドウのデバイス コンテキストのハンドルを取得します。

CDC* GetDCEx( 
   CRgn* prgnClip, 
   DWORD flags  
);

パラメーター

  • prgnClip
    クライアント ウィンドウの表示領域と結合されるクリッピング領域を指定します。

  • flags
    次の設定値から 1 を指定できます:

    • DCX_CACHEOWNDC または CLASSDC のウィンドウではなく、キャッシュからデバイス コンテキストを返します。 オーバーライド CS_OWNDCCS_CLASSDC

    • DCX_CLIPCHILDRENCWnd のウィンドウですべての子ウィンドウの表示領域を除外します。

    • DCX_CLIPSIBLINGSCWnd のウィンドウの一番上のすべての兄弟ウィンドウの表示領域を除外します。

    • DCX_EXCLUDERGN は、返されたデバイス コンテキストの表示領域から prgnClip によって識別されるクリッピング領域は含まれません。

    • DCX_INTERSECTRGN は、返されたデバイス コンテキストの表示領域内の prgnClip によって識別されるクリッピング領域の交差します。

    • DCX_LOCKWINDOWUPDATE は、このウィンドウを除く仮想 LockWindowUpdate の呼び出しが行われても描画割り当てます。 この値は、追跡の間に描画に使用されます。

    • DCX_PARENTCLIP は、親ウィンドウの表示領域を使用し、親ウィンドウの WS_CLIPCHILDRENWS_PARENTDC のスタイル ビット無視されます。 この値は CWnd のウィンドウの左上隅にデバイス コンテキストの原点を設定します。

    • DCX_WINDOW は、クライアントの四角形はなく、ウィンドウの四角形に対応するデバイス コンテキストを返します。

戻り値

関数が成功した場合は、指定されたウィンドウのデバイス コンテキスト; それ null

解説

デバイス コンテキストはクライアント領域の描画への後続 GDI 関数で使用できます。

GetDC の関数に対する拡張子であるこの関数は、ウィンドウのデバイス コンテキストがクリップするかをアプリケーションに方法を詳細に制御、およびできます。

デバイス コンテキストがウィンドウ クラスに属する必要描画の後にコンテキストを解放するために、ReleaseDC 関数を呼び出す必要があります。 5 とおりのデバイス コンテキストのみいつでも使用できるため、デバイス コンテキストを解放するエラーはことで、他のアプリケーションがデバイス コンテキストにアクセスする方法を回避できます。

キャッシュされたデバイス コンテキストを取得するには、アプリケーションは DCX_CACHEを指定する必要があります。 DCX_CACHE が指定されず、ウィンドウが CS_OWNDC、または、CS_CLASSDCでない場合、この関数の戻り値 null

特殊な特徴のデバイス コンテキストは GetDCEx の関数によってクラスを登録したときに CS_CLASSDCCS_OWNDC、または CS_PARENTDC のスタイルが WNDCLASS の構造体に指定された場合にを返します。

これらの特性に関する詳細については、Windows SDKの WNDCLASS の構造体の説明を参照してください。

必要条件

ヘッダー: afxwin.h

参照

関連項目

CWnd クラス

階層図

CWnd::BeginPaint

CWnd::GetDC

CWnd::GetWindowDC

CWnd::ReleaseDC

GetDCEx