共用方式為


getSysColor 函式 (winuser.h)

擷取指定之顯示專案的目前色彩。 顯示專案是視窗的元件,以及顯示在系統顯示畫面上的顯示器。

語法

DWORD GetSysColor(
  [in] int nIndex
);

參數

[in] nIndex

類型: int

要擷取其色彩的顯示專案。 此參數可以是下列其中一個值。

意義
COLOR_3DDKSHADOW
21
三維顯示元素的深色陰影。

Windows 10或更新版本:不支援此值。

COLOR_3DFACE
15
三維顯示元素和對話方塊背景的臉部色彩。
COLOR_3DHIGHLIGHT
20
醒目提示三維顯示元素的色彩, (面向光源的邊緣。)

Windows 10或更新版本:不支援此值。

COLOR_3DHILIGHT
20
醒目提示三維顯示元素的色彩, (面向光源的邊緣。)

Windows 10或更新版本:不支援此值。

COLOR_3DLIGHT
22
三維顯示元素的淺色, (面向光源的邊緣。)

Windows 10或更新版本:不支援此值。

COLOR_3DSHADOW
16
三維顯示元素的陰影色彩, (面向光源) 的邊緣。

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
三維顯示元素和對話方塊背景的臉部色彩。 相關聯的前景色彩 COLOR_BTNTEXT

Windows 10或更新版本:不支援此值。

COLOR_BTNHIGHLIGHT
20
醒目提示三維顯示元素的色彩, (面向光源的邊緣。)

Windows 10或更新版本:不支援此值。

COLOR_BTNHILIGHT
20
醒目提示三維顯示元素的色彩, (面向光源的邊緣。)

Windows 10或更新版本:不支援此值。

COLOR_BTNSHADOW
16
三維顯示元素的陰影色彩, (面向光源) 的邊緣。

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 參數超出範圍,則傳回值為零。 因為零也是有效的 RGB 值,所以您無法使用 GetSysColor 來判斷目前平臺是否支援系統色彩。 請改用 GetSysColorBrush 函式,如果不支援色彩,則會傳回 Null

備註

若要顯示 RGB 值的元件,請使用 GetRValueGetGValueGetBValue 宏。

單色顯示器的系統色彩通常會解譯為灰色的陰影。

若要使用系統色彩筆刷繪製,應用程式應該使用 GetSysColorBrush(nIndex) ,而不是 CreateSolidBrush(GetSysColor(nIndex)) ,因為 GetSysColorBrush 會傳回快取的筆刷,而不是配置新的筆刷。

色彩是大部分使用者介面的重要視覺元素。 如需在應用程式中使用色彩的指導方針,請參閱Color - Win32Windows 11 中的色彩

Windows 10/11 系統色彩

下表顯示Windows 10和Windows 11中支援的值,以及來自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 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 winuser.h (包括 Windows.h)
程式庫 User32.lib
Dll User32.dll

另請參閱

CreateSolidBrush

GetSysColorBrush

SetSysColors

SystemParametersInfo