GetWindowDC 関数 (winuser.h)

[アーティクル]
08/27/2023

GetWindowDC 関数は、タイトルバー、メニュー、スクロールバーなど、ウィンドウ全体のデバイスコンテキスト (DC) を取得します。ウィンドウデバイスコンテキストでは、デバイスコンテキストの原点がクライアント領域ではなくウィンドウの左上隅であるため、ウィンドウ内の任意の場所に描画できます。

GetWindowDC は、デバイスコンテキストを取得するたびに、ウィンドウデバイスコンテキストに既定の属性を割り当てます。以前の属性は失われます。

構文

HDC GetWindowDC(
  [in] HWND hWnd
);

パラメーター

[in] hWnd

取得するデバイスコンテキストを持つウィンドウへのハンドル。この値が NULL の場合、 GetWindowDC は画面全体のデバイスコンテキストを取得します。

このパラメーターが NULL の場合、 GetWindowDC はプライマリディスプレイモニターのデバイスコンテキストを取得します。他のディスプレイモニターのデバイスコンテキストを取得するには、 EnumDisplayMonitors 関数と CreateDC 関数を使用します。

戻り値

関数が成功した場合、戻り値は、指定されたウィンドウのデバイスコンテキストへのハンドルです。

関数が失敗した場合、戻り値は NULL で、エラーまたは無効な hWnd パラメーターを示します。

注釈

GetWindowDC は、ウィンドウの非クライアント領域内の特殊な描画効果を目的としています。任意のウィンドウの非クライアント領域での描画はお勧めしません。

GetSystemMetrics 関数を使用すると、タイトルバー、メニュー、スクロールバーなど、非クライアント領域のさまざまな部分のディメンションを取得できます。

GetDC 関数を使用すると、画面全体のデバイスコンテキストを取得できます。

描画が完了したら、デバイスコンテキストを解放するために ReleaseDC 関数を呼び出す必要があります。ウィンドウデバイスコンテキストを解放しないと、アプリケーションによって要求された描画に重大な影響があります。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	winuser.h (Windows.h を含む)
Library	User32.lib
[DLL]	User32.dll
API セット	ext-ms-win-ntuser-draw-l1-1-0 (Windows 8で導入)