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)