setDCBrushColor 函式 (wingdi.h)
SetDCBrushColor 函 式會將目前的裝置內容 (DC) 筆刷色彩設定為指定的色彩值。 如果裝置無法代表指定的色彩值,則色彩會設定為最接近的實體色彩。
語法
COLORREF SetDCBrushColor(
[in] HDC hdc,
[in] COLORREF color
);
參數
[in] hdc
DC 的句柄。
[in] color
新的筆刷色彩。
傳回值
如果函式成功,傳回值會將先前的 DC 筆刷色彩指定為 COLORREF 值。
如果函式失敗,則傳回值是 CLR_INVALID。
備註
在 DC 中選取股票DC_BRUSH時,所有後續繪圖都會使用 DC 筆刷色彩來完成,直到取消選取股票筆刷為止。 默認DC_BRUSH色彩為 WHITE。
函式會傳回先前的DC_BRUSH色彩,即使 DC 中未選取股票筆刷DC_BRUSH:不過,在 DC 中選取股票DC_BRUSH之前,這不會用於繪圖作業。
具有自變數的 GetStockObject 函式DC_BRUSH或DC_PEN可以與 SetDCPenColor 和 SetDCBrushColor 函式交替使用。
Icm: 如果已啟用 ICM,則會執行色彩管理。
範例
如需設定色彩的範例,請參閱 設定畫筆或筆刷色彩。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | wingdi.h (包含 Windows.h) |
程式庫 | Gdi32.lib |
Dll | Gdi32.dll |