GetSysColor

指定された表示要素の現在の色を取得する。

GetSysColor nIndex

nIndex : [int] 型: int

(プラグイン / モジュール : user32.dll)

解説

指定された表示要素の現在の色を取得する。

[戻り値]
型: DWORD 関数は指定要素の RGB 色値を返す。nIndex が範囲外の場合、戻り値はゼロである。ゼロも有効な RGB
値なので、GetSysColor でシステム色がサポートされているか判断することはできない。代わりに GetSysColorBrush
を使う(サポートされていなければ NULL を返す)。

[備考]
RGB 値の各成分を表示するには GetRValue, GetGValue, GetBValue
マクロを使う。モノクロディスプレイでのシステムカラーは通常グレーの濃淡として解釈される。システムカラーのブラシで描画する際は、GetSysColorBrush(nIndex)
を使うべきである。CreateSolidBrush(GetSysColor(nIndex))
では毎回新しいブラシを確保してしまうが、GetSysColorBrush はキャッシュ済みブラシを返す。色はほとんどの UI
にとって重要な視覚要素である。アプリケーションでの色の使用ガイドラインについては Color - Win32 および Color in
Windows 11 を参照。

情報