ImageAttributes::ClearThreshold 方法 (gdiplusimageattributes.h)

ImageAttributes::ClearThreshold 方法清除指定类别的阈值。

语法

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

parameters

[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 值;相反,笔类别将没有伽玛值。

要求

   
最低受支持的客户端 Windows XP、Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 gdiplusimageattributes.h (包括 Gdiplus.h)
Library Gdiplus.lib
DLL Gdiplus.dll

另请参阅

Bitmap

ColorAdjustType

图像

ImageAttributes

ImageAttributes::ClearColorKey

ImageAttributes::SetColorKey

ImageAttributes::SetThreshold

Metafile

重新着色