getSysColor 函式 (winuser.h)

發行項
08/27/2023

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

語法

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 值的元件，請使用 GetRValue、 GetGValue和 GetBValue 宏。

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

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

色彩是大部分使用者介面的重要視覺元素。如需在應用程式中使用色彩的指導方針，請參閱Color - Win32和Windows 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 + 醒目提示
	COLOR_BTNTEXT + COLOR_3DFACE

範例

如需範例，請參閱 SetSysColors。

規格需求


最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	winuser.h (包括 Windows.h)
程式庫	User32.lib
Dll	User32.dll

另請參閱

色彩監看式	描述
	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配對

共用方式為

getSysColor 函式 (winuser.h)

語法

參數

傳回值

備註

Windows 10/11 系統色彩

範例

規格需求

另請參閱

意見反應

其他資源