GetWindowDC

非クライアント領域（タイトルバー、メニュー、スクロールバーなど）を含むウィンドウ全体のデバイスコンテキストのハンドルを取得します。

HDC GetWindowDC(
    HWND hWnd     // window handle
);

USER32.DLL

引数

hWnd

デバイスコンテキストを取得するウィンドウのハンドルを指定します。0 (NULL) を指定すると、スクリーン全体のデバイスコンテキストを取得します。

Windows 98/Me/2000/XP： このパラメータに0 (NULL) を指定すると、プライマリディスプレイモニタのデバイスコンテキストを取得します。他のディスプレイモニタのデバイスコンテキストを取得するには、EnumDisplayMonitors関数およびCreateDC関数を使います。

戻り値

成功するとデバイスコンテキストのハンドルが返ります。

失敗すると0 (NULL) が返ります。

Windows NT/2000/XP： 拡張エラー情報を取得するには、GetLastError関数を使います。

解説

タイトルバー、メニュー、スクロールバーなどの非クライアント領域のそれぞれの部分の寸法を取得するために、GetSystemMetrics関数を使用することができます。

デバイスコンテキストによる描画が終了したら、ReleaseDC関数を呼び出してデバイスコンテキストを解放しなければなりません。ReleaseDC関数は、GetWindowDC関数を呼び出したスレッドによって呼び出されなくてはいけません。

対応情報

Windows 95 以降 / Windows NT 3.1 以降