ImageAttributes::SetColorMatrix 方法 (gdiplusimageattributes.h)

ImageAttributes::SetColorMatrix方法會設定指定類別的色彩調整矩陣。

語法

Status SetColorMatrix(
  [in]           const ColorMatrix *colorMatrix,
  [in]           ColorMatrixFlags  mode,
  [in, optional] ColorAdjustType   type
);

參數

[in] colorMatrix

類型:const ColorMatrix*

5×5 色彩調整矩陣的指標。

[in] mode

類型: ColorMatrixFlags

ColorMatrixFlags列舉的元素,指定會受到色彩調整矩陣影響的影像和色彩類型。

[in, optional] type

類型: ColorAdjustType

ColorAdjustType列舉的元素,指定設定色彩調整矩陣的類別。 預設值為 ColorAdjustTypeDefault

傳回值

類型: 狀態

如果方法成功,它會傳回 Ok,這是 Status 列舉的元素。

如果方法失敗,它會傳回 Status 列舉的其他其中一個專案。

備註

ImageAttributes物件會維護五個調整類別的色彩和灰階設定:預設、點陣圖、筆刷、畫筆和文字。 例如,您可以指定預設類別的色彩調整矩陣、點陣圖類別的不同色彩調整矩陣,以及畫筆類別的色彩調整矩陣。

預設色彩和灰階調整設定會套用至沒有自己調整設定的所有類別。 例如,如果您從未指定畫筆類別的任何調整設定,則預設設定會套用至畫筆類別。

一旦您指定特定類別的色彩或灰階調整設定,預設調整設定就不再套用至該類別。 例如,假設您指定預設類別的調整設定集合。 如果您藉由將 ColorAdjustTypePen 傳遞至 ImageAttributes::SetColorMatrix 方法來設定畫筆類別的色彩調整矩陣,則不會將任何預設調整設定套用至手寫筆。

規格需求

   
最低支援的用戶端 Windows XP、Windows 2000 Professional [僅限桌面應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平臺 Windows
標頭 gdiplusimageattributes.h (包含 Gdiplus.h)
程式庫 Gdiplus.lib
DLL Gdiplus.dll

另請參閱

點陣圖

色彩

ColorAdjustType

ColorMatrix

映像

ImageAttributes

ImageAttributes::ClearColorMatrices

ImageAttributes::ClearColorMatrix

ImageAttributes::SetColorMatrices

ImageAttributes::SetToIdentity

中繼檔

重新著色