共用方式為


GetSysColorBrush 函式 (winuser.h)

GetSysColorBrush 函式會擷取句柄,識別對應至指定色彩索引的邏輯筆刷。

語法

HBRUSH GetSysColorBrush(
  [in] int nIndex
);

參數

[in] nIndex

色彩索引。 這個值對應於用來繪製其中一個視窗元素的色彩。 如需系統色彩索引值,請參閱 GetSysColor

傳回值

如果目前平臺支持 nIndex 參數,則傳回值會識別邏輯筆刷。 否則,它會傳回 NULL

備註

筆刷是系統用來繪製填滿圖案內部的點陣圖。 應用程式可以藉由呼叫 GetSysColor 函式來擷取目前的系統色彩。 應用程式可以藉由呼叫 SetSysColors 函式來設定目前的系統色彩。

應用程式不得使用系統筆刷為窗口註冊窗口類別。 若要使用系統色彩註冊窗口類別,請參閱 WNDCLASSWNDCLASSEX 結構的 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)

另請參閱

筆刷函式

筆刷概觀

CreateSolidBrush

GetSysColor

SetSysColors

WNDCLASS

WNDCLASSEX