GetSysColorBrush 函式 (winuser.h)
GetSysColorBrush 函式會擷取句柄,識別對應至指定色彩索引的邏輯筆刷。
語法
HBRUSH GetSysColorBrush(
[in] int nIndex
);
參數
[in] nIndex
色彩索引。 這個值對應於用來繪製其中一個視窗元素的色彩。 如需系統色彩索引值,請參閱 GetSysColor 。
傳回值
如果目前平臺支持 nIndex 參數,則傳回值會識別邏輯筆刷。 否則,它會傳回 NULL。
備註
筆刷是系統用來繪製填滿圖案內部的點陣圖。 應用程式可以藉由呼叫 GetSysColor 函式來擷取目前的系統色彩。 應用程式可以藉由呼叫 SetSysColors 函式來設定目前的系統色彩。
應用程式不得使用系統筆刷為窗口註冊窗口類別。 若要使用系統色彩註冊窗口類別,請參閱 WNDCLASS 或 WNDCLASSEX 結構的 hbrBackground 成員檔。
系統色彩筆刷會追蹤系統色彩的變更。 換句話說,當使用者變更系統色彩時,相關聯的系統色彩筆刷會自動變更為新的色彩。
若要使用系統色彩筆刷繪製,應用程式應該使用 GetSysColorBrush (nIndex) ,而不是 CreateSolidBrush ( GetSysColor (nIndex) ) ,因為 GetSysColorBrush 會傳回快取的筆刷,而不是配置新的筆刷。
系統色彩筆刷是由系統所擁有,因此您不需要終結它們。 雖然您不需要刪除 GetSysColorBrush 傳回的邏輯筆刷,但呼叫 DeleteObject 不會造成任何損害。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | winuser.h (包括 Windows.h) |
程式庫 | User32.lib |
Dll | User32.dll |
API 集合 | ext-ms-win-ntuser-gui-l1-1-1 (於 Windows 8.1) |