createSolidBrush 函式 (wingdi.h)

CreateSolidBrush 函式會建立具有指定純色的邏輯筆刷。

語法

HBRUSH CreateSolidBrush(
  [in] COLORREF color
);

參數

[in] color

筆刷的色彩。 若要建立 COLORREF 色彩值,請使用 RGB 宏。

傳回值

如果函式成功,則傳回值會識別邏輯筆刷。

如果函式失敗,則傳回值為 NULL

備註

當您不再需要 HBRUSH 物件時,請呼叫 DeleteObject 函式來刪除它。

純色筆刷是系統用來繪製填滿圖案內部的點陣圖。

應用程式藉由呼叫 CreateSolidBrush 建立筆刷之後,就可以呼叫 SelectObject 函式,將該筆刷選取到任何裝置內容中。

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

Icm: 筆刷建立時不會進行色彩管理。 不過,當筆刷選取為啟用ICM的裝置內容時,就會執行色彩管理。

範例

如需範例,請參閱 建立彩色畫筆和筆刷

規格需求

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

另請參閱

筆刷函式

筆刷概觀

COLORREF

CreateDIBPatternBrush

CreateDIBPatternBrushPt

CreateHatchBrush

CreatePatternBrush

DeleteObject

GetSysColorBrush

RGB

SelectObject