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

Artigo
08/24/2023

O método ImageAttributes::ClearOutputChannelColorProfile limpa a configuração de perfil de cor do canal de saída para uma categoria especificada.

Sintaxe

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

Parâmetros

[in, optional] type

Tipo: ColorAdjustType

Elemento da enumeração ColorAdjustType que especifica a categoria para a qual a configuração de perfil do canal de saída é desmarcada. O valor padrão é ColorAdjustTypeDefault.

Valor retornado

Tipo: Status

Se o método for bem-sucedido, ele retornará Ok, que é um elemento da enumeração Status .

Se o método falhar, ele retornará um dos outros elementos da enumeração Status .

Comentários

Um objeto ImageAttributes mantém as configurações de cor e escala de cinza para cinco categorias de ajuste: padrão, bitmap, pincel, caneta e texto. Por exemplo, você pode especificar um perfil de canal de saída para a categoria padrão e um perfil de canal de saída diferente para a categoria bitmap.

As configurações padrão de ajuste de cor e escala de cinza se aplicam a todas as categorias que não têm configurações de ajuste próprias. Por exemplo, se você nunca especificar nenhuma configuração de ajuste para a categoria de bitmap, as configurações padrão se aplicarão à categoria bitmap.

Assim que você especificar uma configuração de ajuste de escala de cinza ou cor para uma determinada categoria, as configurações de ajuste padrão não se aplicam mais a essa categoria. Por exemplo, suponha que você especifique um perfil de canal de saída e uma matriz de ajuste para a categoria padrão. Se você definir o perfil de canal de saída para a categoria bitmap chamando ImageAttributes::SetOutputChannelColorProfile, o perfil de canal de saída padrão não se aplicará a bitmaps. Se você limpar posteriormente o perfil do canal de saída do bitmap chamando ImageAttributes::ClearOutputChannelColorProfile, a categoria bitmap não reverter ao perfil de canal de saída padrão; em vez disso, a categoria bitmap não terá nenhuma configuração de perfil de canal de saída. Da mesma forma, a categoria de bitmap não reverter à matriz de ajuste de cor padrão; em vez disso, a categoria de bitmap não terá matriz de ajuste de cor.

Requisitos


Cliente mínimo com suporte	Windows XP, Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	gdiplusimageattributes.h (inclua Gdiplus.h)
Biblioteca	Gdiplus.lib
DLL	Gdiplus.dll