ImageAttributes：：ClearColorMatrix 方法 (gdiplusimageattributes.h)

發行項
08/24/2023

ImageAttributes：：ClearColorMatrix方法會清除指定類別的色彩調整矩陣。

語法

Status ClearColorMatrix(
  [in, optional] ColorAdjustType type
);

參數

[in, optional] type

類型： ColorAdjustType

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

傳回值

類型：狀態

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

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

備註

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

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

一旦您指定特定類別的色彩或灰階調整設定，預設調整設定就不再套用至該類別。例如，假設您指定預設類別的色彩調整矩陣和 Gamma 值。如果您藉由呼叫 ImageAttributes：：SetColorMatrix來設定畫筆類別的色彩調整矩陣，則預設色彩調整矩陣不會套用至手寫筆。如果您稍後藉由呼叫 ImageAttributes：：ClearColorMatrix來清除畫筆色彩調整矩陣，則畫筆類別將不會還原為預設調整矩陣;相反地，畫筆類別不會有調整矩陣。同樣地，畫筆類別不會還原為預設 Gamma 值;相反地，畫筆類別不會有 gamma 值。

需求


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