GetSysColor 関数 (winuser.h)
指定した表示要素の現在の色を取得します。 表示要素は、ウィンドウの一部であり、システム表示画面に表示されるディスプレイです。
構文
DWORD GetSysColor(
[in] int nIndex
);
パラメーター
[in] nIndex
型: int
色を取得する表示要素。 このパラメーターには、次の値のいずれかを指定できます。
| 値 | 説明 |
|---|---|
|
3 次元表示要素の濃い影。
Windows 10以上: この値はサポートされていません。 |
|
3 次元表示要素とダイアログ ボックスの背景の面の色。 |
|
3 次元表示要素の強調表示の色 (光源に面するエッジの場合)。 Windows 10以上: この値はサポートされていません。 |
|
3 次元表示要素の強調表示の色 (光源に面するエッジの場合)。 Windows 10以上: この値はサポートされていません。 |
|
3 次元表示要素の明るい色 (光源に面するエッジの場合)。 Windows 10以上: この値はサポートされていません。 |
|
3 次元表示要素の影の色 (光源から離れたエッジの場合)。
Windows 10以上: この値はサポートされていません。 |
|
アクティブなウィンドウ罫線。
Windows 10以上: この値はサポートされていません。 |
|
アクティブなウィンドウ タイトル バー。
関連付けられた前景色が COLOR_CAPTIONTEXT。 グラデーション効果が有効になっている場合に、作業中のウィンドウのタイトル バーの色グラデーションの左側の色を指定します。 Windows 10以上: この値はサポートされていません。 |
|
複数のドキュメント インターフェイス (MDI) アプリケーションの背景色。
Windows 10以上: この値はサポートされていません。 |
|
デスクトップ。
Windows 10以上: この値はサポートされていません。 |
|
3 次元表示要素とダイアログ ボックスの背景の面の色。 関連付けられた前景色が COLOR_BTNTEXT。
Windows 10以上: この値はサポートされていません。 |
|
3 次元表示要素の強調表示の色 (光源に面するエッジの場合)。 Windows 10以上: この値はサポートされていません。 |
|
3 次元表示要素の強調表示の色 (光源に面するエッジの場合)。 Windows 10以上: この値はサポートされていません。 |
|
3 次元表示要素の影の色 (光源から離れたエッジの場合)。
Windows 10以上: この値はサポートされていません。 |
|
プッシュ ボタンのテキスト。 関連付けられた背景色はCOLOR_BTNFACE。 |
|
キャプション、サイズ ボックス、スクロール バーの矢印ボックス内のテキスト。 関連付けられている背景色がCOLOR_ACTIVECAPTION。
Windows 10以上: この値はサポートされていません。 |
|
デスクトップ。
Windows 10以上: この値はサポートされていません。 |
|
作業中のウィンドウのタイトル バーの色グラデーションの右側の色。 COLOR_ACTIVECAPTION左側の色を指定します。 systemParametersInfo 関数でSPI_GETGRADIENTCAPTIONSを使用して、グラデーション効果が有効になっているかどうかを判断します。
Windows 10以上: この値はサポートされていません。 |
|
非アクティブなウィンドウのタイトル バーの色グラデーションの右側の色。 COLOR_INACTIVECAPTION左側の色を指定します。
Windows 10以上: この値はサポートされていません。 |
|
灰色 (無効) テキスト。 現在のディスプレイ ドライバーが単色の灰色をサポートしていない場合、この色は 0 に設定されます。 |
|
コントロールで選択されている項目。 関連付けられた前景色がCOLOR_HIGHLIGHTTEXT。 |
|
コントロールで選択されている項目のテキスト。 関連付けられた背景色はCOLOR_HIGHLIGHT。 |
|
ハイパーリンクまたはホット トラッキングされたアイテムの色。 関連付けられた背景色がCOLOR_WINDOW。 |
|
非アクティブなウィンドウ罫線。
Windows 10以上: この値はサポートされていません。 |
|
非アクティブなウィンドウ キャプション。
関連付けられた前景色がCOLOR_INACTIVECAPTIONTEXT。 グラデーション効果が有効になっている場合に、非アクティブなウィンドウのタイトル バーの色グラデーションの左側の色を指定します。 Windows 10以上: この値はサポートされていません。 |
|
非アクティブなキャプション内のテキストの色。 関連付けられた背景色がCOLOR_INACTIVECAPTION。
Windows 10以上: この値はサポートされていません。 |
|
ヒント コントロールの背景色。 関連付けられた前景色がCOLOR_INFOTEXT。
Windows 10以上: この値はサポートされていません。 |
|
ヒント コントロールのテキストの色。 関連付けられた背景色はCOLOR_INFOBK。
Windows 10以上: この値はサポートされていません。 |
|
メニューの背景。 関連付けられた前景色がCOLOR_MENUTEXT。
Windows 10以上: この値はサポートされていません。 |
|
メニューがフラット メニューとして表示されたときにメニュー項目を強調表示するために使用される色 ( 「SystemParametersInfo」を参照)。 強調表示されたメニュー項目は、COLOR_HIGHLIGHTでアウトライン表示されます。
Windows 2000 Windows 10以降: この値はサポートされていません。 |
|
メニューがフラット メニューとして表示される場合のメニュー バーの背景色 ( 「SystemParametersInfo」を参照)。 ただし、COLOR_MENUはメニュー ポップアップの背景色を指定し続けます。
Windows 2000 Windows 10以降: この値はサポートされていません。 |
|
メニュー内のテキスト。 関連付けられた背景色はCOLOR_MENU。
Windows 10以上: この値はサポートされていません。 |
|
スクロール バーの灰色の領域。
Windows 10以上: この値はサポートされていません。 |
|
ウィンドウの背景。 関連付けられた前景色はCOLOR_WINDOWTEXTされ、COLOR_HOTLITEされます。 |
|
ウィンドウ フレーム。
Windows 10以上: この値はサポートされていません。 |
|
ウィンドウ内のテキスト。 関連付けられた背景色がCOLOR_WINDOW。 |
戻り値
型: DWORD
関数は、指定された要素の赤、緑、青 (RGB) 色の値を返します。
nIndex パラメーターが範囲外の場合、戻り値は 0 になります。 0 も有効な RGB 値であるため、 GetSysColor を使用して、システムの色が現在のプラットフォームでサポートされているかどうかを判断することはできません。 代わりに、 GetSysColorBrush 関数を使用します。この関数は、色がサポートされていない場合は NULL を 返します。
解説
RGB 値のコンポーネントを表示するには、 GetRValue、 GetGValue、および GetBValue マクロを 使用します。
モノクロディスプレイのシステムカラーは通常、灰色の網掛けとして解釈されます。
システム カラー ブラシを使用してペイントするには、GetSysColorBrush は新しいブラシをCreateSolidBrush(GetSysColor(nIndex))割り当てる代わりにキャッシュされたブラシを返すので、アプリケーションでは ではなく を使用GetSysColorBrush(nIndex)する必要があります。
色は、ほとんどのユーザー インターフェイスの重要なビジュアル要素です。 アプリケーションでの色の使用に関するガイドラインについては、「Color - Win32」および「Color in Windows 11」を参照してください。
Windows 10/11 システムの色
次の表は、Windows 10とWindows 11でサポートされている値と、Windows 11水生コントラスト テーマの色の値を示しています。
| 色の見本 | 説明 |
|---|---|
|
COLOR_WINDOWページ、ペイン、ポップアップ、ウィンドウの背景。 COLOR_WINDOWTEXTとペア |
|
COLOR_WINDOWTEXT見出し、本文のコピー、リスト、プレースホルダー テキスト、アプリとウィンドウの罫線、操作できない UI。 COLOR_WINDOWとペア |
|
COLOR_HOTLIGHTハイパーリンク。 COLOR_WINDOWとペア |
|
COLOR_GRAYTEXT非アクティブ (無効) UI。 COLOR_WINDOWとペア |
|
COLOR_HIGHLIGHTTEXT選択中、操作中 (ホバー、押された状態)、または進行中のテキストまたは UI の前景色。 COLOR_HIGHLIGHTとペア |
|
COLOR_HIGHLIGHT選択中、操作中 (ホバー、押された)、または進行中の UI の背景色またはアクセント色。 COLOR_HIGHLIGHTTEXTとペア |
|
COLOR_BTNTEXT操作できるボタンと任意の UI の前景色。 COLOR_3DFACEとペア |
|
COLOR_3DFACEボタンと操作できる UI の背景色。 COLOR_BTNTEXTとペア |
これらの画像は、 COLOR_WINDOWに設定された背景で使用した場合の色の表示方法を示しています。
| 例 | 値 |
|---|---|
|
COLOR_WINDOWTEXT |
|
COLOR_HOTLIGHT |
|
COLOR_GRAYTEXT |
|
COLOR_HIGHLIGHTTEXT + 強調表示 |
|
COLOR_BTNTEXT + COLOR_3DFACE |
例
例については、「 SetSysColors」を参照してください。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winuser.h (Windows.h を含む) |
| Library | User32.lib |
| [DLL] | User32.dll |