次の方法で共有

GetSysColor 関数 (winuser.h)

  • [アーティクル]

指定した表示要素の現在の色を取得します。 表示要素は、ウィンドウの一部であり、システム表示画面に表示されるディスプレイです。

構文

DWORD GetSysColor(
  [in] int nIndex
);

パラメーター

[in] nIndex

型: int

色を取得する表示要素。 このパラメーターには、次の値のいずれかを指定できます。

値 説明
COLOR_3DDKSHADOW
21
 3 次元表示要素の濃い影。

Windows 10以上: この値はサポートされていません。
COLOR_3DFACE
15
 3 次元表示要素とダイアログ ボックスの背景の面の色。
COLOR_3DHIGHLIGHT
20
 3 次元表示要素の強調表示の色 (光源に面するエッジの場合)。

Windows 10以上: この値はサポートされていません。
COLOR_3DHILIGHT
20
 3 次元表示要素の強調表示の色 (光源に面するエッジの場合)。

Windows 10以上: この値はサポートされていません。
COLOR_3DLIGHT
22
 3 次元表示要素の明るい色 (光源に面するエッジの場合)。

Windows 10以上: この値はサポートされていません。
COLOR_3DSHADOW
16
 3 次元表示要素の影の色 (光源から離れたエッジの場合)。

Windows 10以上: この値はサポートされていません。
COLOR_ACTIVEBORDER
10
 アクティブなウィンドウ罫線。

Windows 10以上: この値はサポートされていません。
COLOR_ACTIVECAPTION
2
 アクティブなウィンドウ タイトル バー。

関連付けられた前景色が COLOR_CAPTIONTEXT。

グラデーション効果が有効になっている場合に、作業中のウィンドウのタイトル バーの色グラデーションの左側の色を指定します。

Windows 10以上: この値はサポートされていません。
COLOR_APPWORKSPACE
12
 複数のドキュメント インターフェイス (MDI) アプリケーションの背景色。

Windows 10以上: この値はサポートされていません。
COLOR_BACKGROUND
1
 デスクトップ。

Windows 10以上: この値はサポートされていません。
COLOR_BTNFACE
15
 3 次元表示要素とダイアログ ボックスの背景の面の色。 関連付けられた前景色が COLOR_BTNTEXT。

Windows 10以上: この値はサポートされていません。
COLOR_BTNHIGHLIGHT
20
 3 次元表示要素の強調表示の色 (光源に面するエッジの場合)。

Windows 10以上: この値はサポートされていません。
COLOR_BTNHILIGHT
20
 3 次元表示要素の強調表示の色 (光源に面するエッジの場合)。

Windows 10以上: この値はサポートされていません。
COLOR_BTNSHADOW
16
 3 次元表示要素の影の色 (光源から離れたエッジの場合)。

Windows 10以上: この値はサポートされていません。
COLOR_BTNTEXT
18
 プッシュ ボタンのテキスト。 関連付けられた背景色はCOLOR_BTNFACE。
COLOR_CAPTIONTEXT
9
 キャプション、サイズ ボックス、スクロール バーの矢印ボックス内のテキスト。 関連付けられている背景色がCOLOR_ACTIVECAPTION。

Windows 10以上: この値はサポートされていません。
COLOR_DESKTOP
1
 デスクトップ。

Windows 10以上: この値はサポートされていません。
COLOR_GRADIENTACTIVECAPTION
27
 作業中のウィンドウのタイトル バーの色グラデーションの右側の色。 COLOR_ACTIVECAPTION左側の色を指定します。 systemParametersInfo 関数でSPI_GETGRADIENTCAPTIONSを使用して、グラデーション効果が有効になっているかどうかを判断します。

Windows 10以上: この値はサポートされていません。
COLOR_GRADIENTINACTIVECAPTION
28
 非アクティブなウィンドウのタイトル バーの色グラデーションの右側の色。 COLOR_INACTIVECAPTION左側の色を指定します。

Windows 10以上: この値はサポートされていません。
COLOR_GRAYTEXT
17
 灰色 (無効) テキスト。 現在のディスプレイ ドライバーが単色の灰色をサポートしていない場合、この色は 0 に設定されます。
COLOR_HIGHLIGHT
13
 コントロールで選択されている項目。 関連付けられた前景色がCOLOR_HIGHLIGHTTEXT。
COLOR_HIGHLIGHTTEXT
14
 コントロールで選択されている項目のテキスト。 関連付けられた背景色はCOLOR_HIGHLIGHT。
COLOR_HOTLIGHT
26
 ハイパーリンクまたはホット トラッキングされたアイテムの色。 関連付けられた背景色がCOLOR_WINDOW。
COLOR_INACTIVEBORDER
11
 非アクティブなウィンドウ罫線。

Windows 10以上: この値はサポートされていません。
COLOR_INACTIVECAPTION
3
 非アクティブなウィンドウ キャプション。

関連付けられた前景色がCOLOR_INACTIVECAPTIONTEXT。

グラデーション効果が有効になっている場合に、非アクティブなウィンドウのタイトル バーの色グラデーションの左側の色を指定します。

Windows 10以上: この値はサポートされていません。
COLOR_INACTIVECAPTIONTEXT
19
 非アクティブなキャプション内のテキストの色。 関連付けられた背景色がCOLOR_INACTIVECAPTION。

Windows 10以上: この値はサポートされていません。
COLOR_INFOBK
24
 ヒント コントロールの背景色。 関連付けられた前景色がCOLOR_INFOTEXT。

Windows 10以上: この値はサポートされていません。
COLOR_INFOTEXT
23
 ヒント コントロールのテキストの色。 関連付けられた背景色はCOLOR_INFOBK。

Windows 10以上: この値はサポートされていません。
COLOR_MENU
4
 メニューの背景。 関連付けられた前景色がCOLOR_MENUTEXT。

Windows 10以上: この値はサポートされていません。
COLOR_MENUHILIGHT
29
 メニューがフラット メニューとして表示されたときにメニュー項目を強調表示するために使用される色 ( 「SystemParametersInfo」を参照)。 強調表示されたメニュー項目は、COLOR_HIGHLIGHTでアウトライン表示されます。

Windows 2000 Windows 10以降: この値はサポートされていません。
COLOR_MENUBAR
30
 メニューがフラット メニューとして表示される場合のメニュー バーの背景色 ( 「SystemParametersInfo」を参照)。 ただし、COLOR_MENUはメニュー ポップアップの背景色を指定し続けます。

Windows 2000 Windows 10以降: この値はサポートされていません。
COLOR_MENUTEXT
7
 メニュー内のテキスト。 関連付けられた背景色はCOLOR_MENU。

Windows 10以上: この値はサポートされていません。
COLOR_SCROLLBAR
0
 スクロール バーの灰色の領域。

Windows 10以上: この値はサポートされていません。
COLOR_WINDOW
5
 ウィンドウの背景。 関連付けられた前景色はCOLOR_WINDOWTEXTされ、COLOR_HOTLITEされます。
COLOR_WINDOWFRAME
6
 ウィンドウ フレーム。

Windows 10以上: この値はサポートされていません。
COLOR_WINDOWTEXT
8
 ウィンドウ内のテキスト。 関連付けられた背景色が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 + 強調表示
3d 面の色を使用したボタンと、ボタン テキストの色を使用したボタン テキストを含むウィンドウ。 COLOR_BTNTEXT + COLOR_3DFACE

例

例については、「 SetSysColors」を参照してください。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー winuser.h (Windows.h を含む)
Library User32.lib
[DLL] User32.dll

関連項目

CreateSolidBrush

GetSysColorBrush

SetSysColors

SystemParametersInfo