ImageAttributes：：ClearThreshold 方法 (gdiplusimageattributes.h)

發行項
08/24/2023

ImageAttributes：：ClearThreshold方法會清除指定類別的臨界值。

語法

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

參數

[in, optional] type

類型： ColorAdjustType

ColorAdjustType列舉的元素，指定清除閾值的類別。預設值為 ColorAdjustTypeDefault。

傳回值

類型：狀態

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

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

備註

臨界值是從 0 到 1 的值，指定每個色彩元件的截止點。例如，假設閾值設定為 0.7，假設您呈現的色彩是紅色、綠色和藍色元件為 230、50 和 220。紅色元件 230 大於 0.7×255，因此紅色元件會變更為 255 (完整濃度) 。綠色元件 50 小於 0.7×255，因此綠色元件會變更為 0。藍色元件 220 大於 0.7×255，因此藍色元件會變更為 255。

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

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

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

需求


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