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

Artículo
08/24/2023

El método ImageAttributes::Reset borra todos los ajustes de ajuste de escala de colores y grises para una categoría especificada.

Sintaxis

Status Reset(
  [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 restablece el 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 un valor gamma para la categoría predeterminada, un valor gamma diferente para la categoría de mapa de bits y un valor gamma 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. Puede restablecer la configuración predeterminada de esa categoría llamando a ImageAttributes::Reset. Por ejemplo, supongamos que especifica un valor gamma para la categoría predeterminada. Si establece el valor gamma para la categoría de lápiz llamando a ImageAttributes::SetGamma, el valor gamma predeterminado no se aplicará a los lápices. Si posteriormente pasa ColorAdjustTypePen al método ImageAttributes::Reset , la categoría del lápiz volverá al valor gamma predeterminado.

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