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

Artículo
08/24/2023

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

Sintaxis

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

Parámetros

[in, optional] type

Tipo: ColorAdjustType

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

Valor devuelto

Tipo: Estado

Si el método se realiza 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 una configuración de ajuste de escala de colores o grises 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 matriz de ajuste de color y un valor gamma para la categoría predeterminada. Si establece una matriz de ajuste de color para la categoría de lápiz llamando a ImageAttributes::SetColorMatrix, la matriz de ajuste de color predeterminada no se aplicará a los lápices. Si más adelante borra la matriz de ajuste de color del lápiz llamando a ImageAttributes::ClearColorMatrix, la categoría de lápiz no volverá a la matriz de ajuste predeterminada; en su lugar, la categoría del lápiz no tendrá ninguna matriz de ajuste. Del mismo modo, la categoría del lápiz no revertirá al valor gamma predeterminado; en su lugar, la categoría de lápiz no tendrá ningún valor gamma.

Requisitos


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 (incluya Gdiplus.h)
Library	Gdiplus.lib
Archivo DLL	Gdiplus.dll