Partager via


ColorAdjustLuma, fonction (shlwapi.h)

Modifie la luminosité d’une valeur RVB. La teinte et la saturation ne sont pas affectées.

Syntaxe

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

Paramètres

clrRGB

Type : COLORREF

Valeur RVB initiale.

n

Type : int

Luminosité en unités de 0,1 % de la plage totale. Par exemple, la valeur n = 50 correspond à 5 % de la luminosité maximale.

fScale

Type : BOOL

Si fScale a la valeur TRUE, n spécifie la quantité d’incrémentation ou de décrémentation de la luminance actuelle. Si fScale a la valeur FALSE, n spécifie la luminance absolue.

Valeur retournée

Type : COLORREF

Retourne la valeur RVB modifiée.

Remarques

Si fScale a la valeur TRUE, n peut aller de -1000 à +1000.

Si fScale a la valeur FALSE, n peut être comprise entre 0 et 1 000. Les valeurs de luminance disponibles sont comprises entre 0 et un maximum. Si la valeur demandée est négative ou dépasse la valeur maximale, la luminance est définie sur zéro ou la valeur maximale, respectivement.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête shlwapi.h
Bibliothèque Shlwapi.lib
DLL Shlwapi.dll (version 5.0 ou ultérieure)