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

Artículo
08/24/2023

El método ImageAttributes::ClearOutputChannel borra la configuración del canal de salida cian-magenta-amarillo-negro (CMYK) para una categoría especificada.

Sintaxis

Status ClearOutputChannel(
  [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 configuración del canal de salida. 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 un canal de salida para la categoría predeterminada y otro canal de salida para la categoría de mapa de bits.

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 mapa de bits, la configuración predeterminada se aplica a la categoría de mapa de bits.

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 un canal de salida y una matriz de ajuste para la categoría predeterminada. Si establece el canal de salida para la categoría de mapa de bits llamando a ImageAttributes::SetOutputChannel, el canal de salida predeterminado no se aplicará a los mapas de bits. Si más adelante borra el canal de salida del mapa de bits llamando a ImageAttributes::ClearOutputChannel, la categoría de mapa de bits no volverá al canal de salida predeterminado; en su lugar, la categoría de mapa de bits no tendrá ninguna configuración de canal de salida. Del mismo modo, la categoría de mapa de bits no se revertirá a la matriz de ajuste de color predeterminada; en su lugar, la categoría de mapa de bits no tendrá ninguna matriz de ajuste de color.

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