<Return[G]><Top>

GetDC

Declare Function Api_GetDC& Lib "user32" Alias "GetDC" (ByVal hWnd&)

Declare Function GetDC Lib "user32" Alias "GetDC" (ByVal hwnd As Long) As Long

指定されたウィンドウのクライアント領域または画面全体を表すディスプレイデバイスコンテキストのハンドルを取得する。その後、GDI 関数を使って、返されたデバイスコンテキスト内で描画を行える。

パラメータ
hWnd
    デバイスコンテキストの取得対象となるウィンドウのハンドルを指定する。

    NULL を指定すると、GetDC は画面全体を表すデバイスコンテキストを取得する。
    Windows 98 と Windows 2000:NULL を指定すると、GetDC はプライマリモニタのデバイスコンテキストを取得する。

    他のモニタのデバイスコンテキストを取得するには、EnumDisplayMonitors と CreateDC の各関数を使う。

戻り値
    関数が成功すると、指定したウィンドウのクライアント領域を表すデバイスコンテキストのハンドルが返る。
    関数が失敗すると、NULL が返る。
    Windows NT/2000:拡張エラー情報を取得するには、GetLastError 関数を使う。

解説
    この関数は、指定されたウィンドウで指定されているクラススタイルに応じて、共通、クラス、プライベートいずれかのデバイスコンテキストを取

    得する。GetDC は、共通デバイスコンテキストを取得するたびに既定の属性を割り当てる。

    クラスデバイスコンテキストとプライベートデバイスコンテキストには、以前の属性をそのまま割り当てる。
    共通デバイスコンテキストが不要になったら、ReleaseDC 関数を呼び出して解放する。

    クラスデバイスコンテキストとプライベートデバイスコンテキストは、ReleaseDC 関数を呼び出して解放する必要がない。

    ReleaseDC 関数は、GetDC を呼び出したのと同じスレッドから呼び出さなければならない。

    デバイスコンテキストの数は、利用可能なメモリの量によってのみ制限される。