<Return[UV]><Top>

UpdateColors

Declare Function Api_UpdateColors& Lib "gdi32" Alias "UpdateColors" (ByVal hgdiobj&)

Declare Function UpdateColors Lib "gdi32" Alias "UpdateColors" (ByVal hgdiobj As Long) As Long

クライアント領域内の現在の色を、現在実体化されている論理パレットへ再マップすることにより、指定されたデバイスコンテキストのクライアント領域を更新する。

パラメータ
hgdiobj
    再設定対象の論理パレットのハンドルを指定する。

戻り値
    関数が成功すると、0 以外の値が返る。
    関数が失敗すると、0 が返る。
    Windows NT/2000:拡張エラー情報を取得するには、 関数を使う。

解説
    ストックオブジェクトに対して UnrealizeObject 関数を呼び出すべきではない。たとえば、GetStockObject(DEFAULT_PALETTE) を呼び出

    して取得した既定のパレットは、ストックオブジェクトである。
    hgdiobj パラメータで指定するパレットは、デバイスコンテキストで現在選択されているパレットと同じものでもかまわない。
    Windows 95/98:ブラシの原点の自動追跡機能はサポートされていない。アプリケーションはブラシを使う前に、UnrealizeObject、

    SetBrushOrgEx、SelectObject の各関数を使って、ブラシの位置を整列させなければならない。
    Windows 2000:hgdiobj がブラシである場合、UnrealizeObject は何もせず、0 以外の値(TRUE)を返す。ブラシの原点を設定するには、

    SetBrushOrgEx を使う。