共用方式為


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可以與 SetDCPenColorSetDCBrushColor 函式交替使用。

Icm: 如果已啟用 ICM,則會執行色彩管理。

範例

如需設定色彩的範例,請參閱 設定畫筆或筆刷色彩

規格需求

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

另請參閱

COLORREF

裝置內容函式

裝置內容概觀

GetDCBrushColor