GetSysColorBrush

指定されたシステムカラー(各々のディスプレイ要素で現在使用されている色)に対応する論理ブラシのハンドルを取得します。

HBRUSH GetSysColorBrush(
    int  nIndex    // システムカラーのインデックス
);

USER32.DLL

引数

nIndex

システムカラーのインデックスを指定します。 GetSysColor 関数の nIndex パラメータで指定される値を指定します。

戻り値

nIndex パラメータで指定されたカラーインデックスが現在のプラットホームでサポートされている場合は、論理ブラシのハンドルが返ります。

それ以外の場合は 0 (NULL) が返ります。

解説

アプリケーションは、ウィンドウクラスを登録するときに GetSysColorBrush 関数で取得されるシステムブラシを使用してはいけません。

ユーザーによってシステムカラーが変更された場合に、関連するシステムカラーブラシは自動的に新しいブラシに変更されます。

GetSysColorBrush 関数は、新しいブラシを作成するのではなく、キャッシュされているブラシを返します。したがって、システムカラーのブラシを使用して描画する場合には、 CreateSolidBrush 関数でブラシを作成するのはでなく、 GetSysColorBrush 関数を使って取得したブラシを使用するべきです。

システムカラーブラシはシステムによって所有されています。このブラシを削除してはいけません。

対応情報

Windows 95 以降 / Windows NT 3.51 以降