Método ImageAttributes::SetColorMatrix (gdiplusimageattributes.h)

Artículo
02/26/2024

El método ImageAttributes::SetColorMatrix establece la matriz de ajuste de color para una categoría especificada.

Sintaxis

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

Parámetros

[in] colorMatrix

Tipo: const ColorMatrix*

Puntero a una matriz de ajuste de color de 5×5.

[in] mode

Tipo: ColorMatrixFlags

Elemento de la enumeración ColorMatrixFlags que especifica el tipo de imagen y color que se verá afectado por la matriz de ajuste de color.

[in, optional] type

Tipo: ColorAdjustType

Elemento de la enumeración ColorAdjustType que especifica la categoría para la que se establece la matriz de ajuste de color. El valor predeterminado es ColorAdjustTypeDefault.

Valor devuelto

Tipo: Estado

Si el método se ejecuta correctamente, devuelve Ok, que es un elemento de la enumeración Status .

Si se produce un error en el método, devuelve uno de los otros elementos de la enumeración Status .

Comentarios

Un objeto ImageAttributes mantiene la configuración de color y escala de grises para cinco categorías de ajuste: predeterminado, mapa de bits, pincel, lápiz y texto. Por ejemplo, puede especificar una matriz de ajuste de color para la categoría predeterminada, una matriz de ajuste de color diferente para la categoría de mapa de bits y una matriz de ajuste de color diferente para la categoría de lápiz.

La configuración predeterminada de ajuste de escala de grises y color se aplica a todas las categorías que no tienen ajustes de ajuste propios. Por ejemplo, si nunca especifica ninguna configuración de ajuste para la categoría de lápiz, la configuración predeterminada se aplica a la categoría de lápiz.

En cuanto especifique un ajuste de ajuste de escala de grises o de color para una determinada categoría, la configuración de ajuste predeterminada ya no se aplica a esa categoría. Por ejemplo, supongamos que especifica una colección de opciones de ajuste para la categoría predeterminada. Si establece la matriz de ajuste de color para la categoría de lápiz pasando ColorAdjustTypePen al método ImageAttributes::SetColorMatrix , no se aplicará ninguno de los ajustes de ajuste predeterminados a los lápices.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP, Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	gdiplusimageattributes.h (include Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll