共用方式為


SetDCPenColor 函式 (wingdi.h)

SetDCPenColor 函式會將目前的裝置內容 (DC) 畫筆色彩設定為指定的色彩值。 如果裝置無法代表指定的色彩值,則色彩會設定為最接近的實體色彩。

語法

COLORREF SetDCPenColor(
  [in] HDC      hdc,
  [in] COLORREF color
);

參數

[in] hdc

DC 的句柄。

[in] color

新的畫筆色彩。

傳回值

如果函式成功,傳回值會將先前的DC畫筆色彩指定為 COLORREF 值。 如果函式失敗,則傳回值是 CLR_INVALID。

備註

函式會傳回先前的DC_PEN色彩,即使 DC 中未選取股票筆DC_PEN也一樣;不過,在 DC 中選取股票DC_PEN之前,這不會用於繪圖作業。

具有DC_BRUSH或DC_PEN自變數的 GetStockObject 函式可以與 SetDCPenColor 和SetDCBrushColor 函式交換使用。

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

範例

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

規格需求

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

另請參閱

COLORREF

裝置內容函式

裝置內容概觀

GetDCPenColor