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

Artículo
02/26/2024

El método ImageAttributes::ClearRemapTable borra la tabla de reasignación de color de una categoría especificada.

Sintaxis

Status ClearRemapTable(
  [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 tabla de reasignación. 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 tabla de reasignación para la categoría predeterminada, una tabla de reasignación diferente para la categoría de mapa de bits y una tabla de reasignación 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 tabla de reasignación y un valor gamma para la categoría predeterminada. Si establece la tabla de reasignación para la categoría de lápiz llamando a ImageAttributes::SetRemapTable, la tabla de reasignación predeterminada no se aplicará a los lápices. Si posteriormente borra la tabla de reasignación del lápiz llamando a ImageAttributes::ClearRemapTable, la categoría de lápiz no volverá a la tabla de reasignación predeterminada; en su lugar, la categoría de lápiz no tendrá ninguna tabla de reasignación. Del mismo modo, la categoría de lápiz no revertirá al valor gamma predeterminado; en su lugar, la categoría del lápiz no tendrá ningún valor gamma.

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