GetThemeSysColorBrush 函式 (uxtheme.h)
擷取系統色彩筆刷。
語法
HBRUSH GetThemeSysColorBrush(
[in] HTHEME hTheme,
[in] int iColorId
);
參數
[in] hTheme
類型: HTHEME
主題資料的控制碼。
[in] iColorId
類型: int
int類型的值,指定所需的系統色彩數目。 可能是下列其中一個值。
值 |
意義 |
- TMT_SCROLLBAR
|
捲軸的色彩。
|
- TMT_BACKGROUND
|
背景的色彩。
|
- TMT_ACTIVECAPTION
|
使用中視窗上標題區域的色彩。
|
- TMT_INACTIVECAPTION
|
非使用中視窗上標題區域的色彩。
|
- TMT_WINDOW
|
視窗的色彩。
|
- TMT_WINDOWFRAME
|
視窗周圍框架的色彩。
|
- TMT_MENUTEXT
|
在功能表上繪製的文字色彩。
|
- TMT_WINDOWTEXT
|
在視窗中繪製的文字色彩。
|
- TMT_CAPTIONTEXT
|
使用中視窗標題區域中繪製的文字色彩。
|
- TMT_ACTIVEBORDER
|
使用中視窗周圍框線的色彩。
|
- TMT_INACTIVEBORDER
|
非使用中視窗周圍的框線色彩。
|
- TMT_APPWORKSPACE
|
應用程式工作區的色彩。
|
- TMT_HIGHLIGHT
|
醒目提示的色彩。
|
- TMT_HIGHLIGHTTEXT
|
醒目提示文字的色彩。
|
- TMT_BTNFACE
|
按鈕臉部的色彩。
|
- TMT_BTNSHADOW
|
按鈕下方陰影的色彩。
|
- TMT_GRAYTEXT
|
暗灰色文字的色彩。
|
- TMT_BTNTEXT
|
按鈕中包含的文字色彩。
|
- TMT_INACTIVECAPTIONTEXT
|
非使用中視窗標題區域中的文字色彩。
|
- TMT_BTNHIGHLIGHT
|
按鈕周圍醒目提示的色彩。
|
- TMT_DKSHADOW3D
|
三維深色陰影的色彩。
|
- TMT_LIGHT3D
|
三維光線區域的色彩。
|
- TMT_INFOTEXT
|
參考文字的色彩。
|
- TMT_INFOBK
|
資訊文字背後的背景色彩。
|
- TMT_BUTTONALTERNATEFACE
|
按鈕的替代臉部色彩。
|
- TMT_HOTTRACKING
|
當使用者將滑鼠移至控制項上方時套用的醒目提示色彩。
|
- TMT_GRADIENTACTIVECAPTION
|
套用至使用中視窗標題區域的漸層色彩。
|
- TMT_GRADIENTINACTIVECAPTION
|
套用至非使用中視窗標題區域的漸層色彩。
|
- TMT_MENUHILIGHT
|
當使用者將滑鼠移至功能表項目上方時,在功能表項目上繪製的醒目提示色彩。
|
- TMT_MENUBAR
|
功能表列的色彩。
|
傳回值
類型: HBRUSH
筆刷資料的控制碼。
如果主題資料控制碼不是 Null 控制碼, GetThemeSysColorBrush 會傳回筆刷,該筆刷符合視覺化樣式之 SysMetrics 區段的指定色彩。 如果主題資料控制碼為 Null,函式會傳回符合全域系統色彩的筆刷。
當不再需要 使用 DeleteObject時,應該釋放此函式所傳回的筆刷控制碼。
規格需求
|
|
最低支援的用戶端 |
Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows Server 2003 [僅限桌面應用程式] |
目標平台 |
Windows |
標頭 |
uxtheme.h |
程式庫 |
UxTheme.lib |
Dll |
UxTheme.dll |