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