Compartilhar via

Função ColorAdjustLuma (shlwapi.h)

  • Artigo

Altera a luminância de um valor RGB. Matiz e saturação não são afetados.

Sintaxe

COLORREF ColorAdjustLuma(
  COLORREF clrRGB,
  int      n,
  BOOL     fScale
);

Parâmetros

clrRGB

Tipo: COLORREF

O valor RGB inicial.

n

Tipo: int

A luminância em unidades de 0,1% do intervalo total. Por exemplo, um valor de n = 50 corresponde a 5% da luminância máxima.

fScale

Tipo: BOOL

Se fScale for definido como TRUE, n especificará quanto incrementar ou diminuir a luminância atual. Se fScale for definido como FALSE, n especificará a luminância absoluta.

Retornar valor

Tipo: COLORREF

Retorna o valor RGB modificado.

Comentários

Se fScale for definido como TRUE, n poderá variar de -1000 a +1000.

Se fScale for definido como FALSE, n poderá variar de 0 a 1000. Os valores de luminância disponíveis variam de 0 a um máximo. Se o valor solicitado for negativo ou exceder o máximo, a luminância será definida como zero ou o valor máximo, respectivamente.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional, Windows XP [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 shlwapi.h
Biblioteca Shlwapi.lib
DLL Shlwapi.dll (versão 5.0 ou posterior)