ImageAttributes：：SetColorMatrices 方法 (gdiplusimageattributes.h)

项目
08/24/2023

ImageAttributes：：SetColorMatrices 方法设置指定类别的颜色调整矩阵和灰度调整矩阵。

语法

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

参数

[in] colorMatrix

类型： const ColorMatrix*

指向 5×5 颜色调整矩阵的指针。

[in] grayMatrix

类型： const ColorMatrix*

指向 5×5 灰度调整矩阵的指针。

[in, optional] mode

类型： ColorMatrixFlags

ColorMatrixFlags 枚举的元素，指定将受颜色调整矩阵和灰度调整矩阵影响的图像和颜色的类型。默认值为 ColorMatrixFlagsDefault。

[in, optional] type

类型： ColorAdjustType

ColorAdjustType 枚举的元素，指定设置颜色调整矩阵和灰度调整矩阵的类别。默认值为 ColorAdjustTypeDefault。

返回值

类型：状态

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

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

注解

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

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

为特定类别指定颜色或灰度调整设置后，默认调整设置将不再应用于该类别。例如，假设为默认类别指定调整设置的集合。如果通过将 ColorAdjustTypePen 传递给 ImageAttributes：：SetColorMatrices 方法来设置笔类别的颜色调整矩阵和灰度调整矩阵，则默认调整设置都不会应用于笔。

要求

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