指定された色のインデックス番号に対応する、論理ブラシのハンドルを取得します。

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

パラメータ

nIndex

1 つの色のインデックス番号を指定します。この値は、いずれかのウィンドウ要素を描画するために使われている色に対応します。

戻り値

現在のプラットフォームが nIndex パラメータをサポートしている場合、論理ブラシのハンドルが返ります。それ以外の場合、NULL が返ります。

解説

ブラシとは、システムが図形の内部を描画する際に使うビットマップのことです。アプリケーションは、GetSysColor 関数を呼び出すと、現在のシステムカラーを取得できます。また、 関数を呼び出すと、現在のシステムカラーを設定できます。

アプリケーションは、システムブラシを使うウィンドウ用のウィンドウクラスを登録してはなりません。

システムカラーのブラシは、システムカラーの変化を自動的に追跡します。言い換えると、ユーザーがシステムカラーを変更した場合、それに関連付けられているシステムカラーのブラシは、自動的に新しい色へ変化します。

システムカラーのブラシを使って描画を行うには、アプリケーションは CreateSolidBrush(GetSysColor(nIndex)) の代わり GetSysColorBrush(nIndex) を使うべきです。GetSysColorBrush は、新しいブラシを割り当てる代わりに、キャッシュに置かれているブラシを返すからです。

対応情報

Windows NT/2000：Windows NT 3.51 以降
Windows 95/98：Windows 95 以降
ヘッダー：Winuser.h 内で宣言、Windows.h をインクルード
インポートライブラリ：User32.lib を使用

参照

CreateSolidBrush, ,