GetSysColorBrush 関数 (winuser.h)
GetSysColorBrush 関数は、指定した色インデックスに対応する論理ブラシを識別するハンドルを取得します。
構文
HBRUSH GetSysColorBrush(
[in] int nIndex
);
パラメーター
[in] nIndex
色のインデックス。 この値は、ウィンドウ要素の 1 つを描画するために使用される色に対応します。 システムカラーインデックス値については 、GetSysColor を参照してください。
戻り値
nIndex パラメーターが現在のプラットフォームでサポートされている場合、戻り値は論理ブラシを識別します。 それ以外の場合は NULL を返します。
注釈
ブラシは、塗りつぶされた図形の内部を描画するためにシステムが使用するビットマップです。 アプリケーションは 、GetSysColor 関数を呼び出すことによって、現在のシステムの色を取得できます。 アプリケーションは 、SetSysColors 関数を呼び出すことによって、現在のシステムの色を設定できます。
アプリケーションでは、システム ブラシを使用してウィンドウのウィンドウ クラスを登録することはできません。 システムの色でウィンドウ クラスを登録するには、WNDCLASS または WNDCLASSEX 構造体の hbrBackground メンバーのドキュメントを参照してください。
システム カラー ブラシは、システムの色の変更を追跡します。 つまり、ユーザーがシステムカラーを変更すると、関連付けられているシステムカラーブラシが自動的に新しい色に変わります。
システム カラー ブラシを使用して描画するには、アプリケーションで CreateSolidBrush (GetSysColor (nIndex) ではなく GetSysColorBrush (nIndex) を使用する必要があります。GetSysColorBrush は、新しいブラシを割り当てる代わりにキャッシュされたブラシを返すからです。
システム カラー ブラシはシステムによって所有されているため、それらを破棄する必要はありません。 GetSysColorBrush から返される論理ブラシを削除する必要はありませんが、DeleteObject を呼び出すことで害は発生しません。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winuser.h (Windows.h を含む) |
| Library | User32.lib |
| [DLL] | User32.dll |
| API セット | ext-ms-win-ntuser-gui-l1-1-1 (Windows 8.1で導入) |