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，則會執行色彩管理。

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