ImageAttributes：：ClearColorMatrix 方法 (gdiplusimageattributes.h)

项目
08/24/2023

ImageAttributes：：ClearColorMatrix 方法清除指定类别的颜色调整矩阵。

语法

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

parameters

[in, optional] type

类型： ColorAdjustType

ColorAdjustType 枚举的元素，指定为其清除颜色调整矩阵的类别。默认值为 ColorAdjustTypeDefault。

返回值

类型：状态

如果方法成功，则返回 Ok，这是 Status 枚举的元素。

如果方法失败，它将返回 Status 枚举的其他元素之一。

注解

ImageAttributes 对象维护五个调整类别的颜色和灰度设置：默认、位图、画笔、笔和文本。例如，可以为默认类别指定颜色调整矩阵，为位图类别指定不同的颜色调整矩阵，为笔类别指定不同的颜色调整矩阵。

默认颜色和灰度调整设置适用于没有自己调整设置的所有类别。例如，如果从未为笔类别指定任何调整设置，则默认设置将应用于笔类别。

为特定类别指定颜色或灰度调整设置后，默认调整设置将不再应用于该类别。例如，假设为默认类别指定颜色调整矩阵和伽玛值。如果通过调用 ImageAttributes：：SetColorMatrix 为笔类别设置颜色调整矩阵，则默认颜色调整矩阵将不适用于笔。如果稍后通过调用 ImageAttributes：：ClearColorMatrix 清除笔颜色调整矩阵，则笔类别不会还原默认调整矩阵;而笔类别将没有调整矩阵。同样，笔类别不会还原默认的 gamma 值;相反，笔类别将没有伽玛值。

要求


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