GetWindowDC

GetWindowDC 関数は、タイトルバー、メニュー、スクロールバーを含むウィンドウ全体のデバイスコンテキスト(DC)を取得する。

GetWindowDC hWnd

hWnd : [intptr] デバイスコンテキストを取得する対象のウィンドウへのハンドル。NULL の場合、GetWindowDC は画面全体のデバイスコンテキストを取得する。このパラメータが NULL の場合、プライマリディスプレイモニタのデバイスコンテキストが取得される。他のディスプレイモニタのデバイスコンテキストを得るには EnumDisplayMonitors と CreateDC 関数を使う。

(プラグイン / モジュール : user32.dll)

解説

GetWindowDC 関数は、タイトルバー、メニュー、スクロールバーを含むウィンドウ全体のデバイスコンテキスト(DC)を取得する。

[戻り値]
関数が成功した場合、戻り値は指定ウィンドウのデバイスコンテキストへのハンドルである。関数が失敗した場合、戻り値は NULL
となり、エラーまたは無効な hWnd を示す。

[備考]
GetWindowDC
は、ウィンドウの非クライアント領域内での特殊な描画効果のためにある。任意のウィンドウの非クライアント領域への描画は推奨されない。タイトルバー、メニュー、スクロールバーなど非クライアント領域の各部の寸法は
GetSystemMetrics で取得できる。画面全体のデバイスコンテキストを取得するには GetDC 関数を使う。描画が完了したら
ReleaseDC
でデバイスコンテキストを解放しなければならない。ウィンドウデバイスコンテキストを解放しないとアプリケーションの描画に重大な影響が出る。

情報

プラグイン / モジュールuser32.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の user32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_user32_gen2.hs