Método ImageAttributes::ClearThreshold (gdiplusimageattributes.h)
O método ImageAttributes::ClearThreshold limpa o valor limite de uma categoria especificada.
Sintaxe
Status ClearThreshold(
[in, optional] ColorAdjustType type
);
Parâmetros
[in, optional] type
Tipo: ColorAdjustType
Elemento da enumeração ColorAdjustType que especifica a categoria para a qual o limite é limpo. 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
O limite é um valor de 0 a 1 que especifica um ponto de corte para cada componente de cor. Por exemplo, suponha que o limite seja definido como 0,7 e suponha que você esteja renderizando uma cor cujos componentes vermelho, verde e azul são 230, 50 e 220. O componente vermelho, 230, é maior que 0,7×255, portanto, o componente vermelho será alterado para 255 (intensidade total). O componente verde, 50, é menor que 0,7×255, portanto, o componente verde será alterado para 0. O componente azul, 220, é maior que 0,7×255, portanto, o componente azul será alterado para 255.
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 limite para a categoria padrão, um limite diferente para a categoria bitmap e ainda um limite diferente para a categoria de caneta.
As configurações padrão de ajuste de escala de cores e 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 caneta, as configurações padrão se aplicarão à categoria de caneta.
Assim que você especificar uma configuração de ajuste de escala de cor ou cinza 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 limite e um valor gama para a categoria padrão. Se você definir o limite para a categoria de caneta chamando ImageAttributes::SetThreshold, o limite padrão não se aplicará a canetas. Se você limpar posteriormente o limite de caneta chamando ImageAttributes::ClearThreshold, a categoria de caneta não reverter ao limite padrão; em vez disso, a categoria de caneta não terá limite. Da mesma forma, a categoria de caneta não reverter ao valor gama padrão; em vez disso, a categoria de caneta não terá nenhum valor gama.
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 |