ColorAdjustLuma 函数 (shlwapi.h)

更改 RGB 值的亮度。 色调和饱和度不受影响。

语法

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

参数

clrRGB

类型: COLORREF

初始 RGB 值。

n

类型: int

以总范围 0.1% 的单位表示的亮度。 例如, n = 50 的值对应于最大亮度的 5%。

fScale

类型: BOOL

如果 fScale 设置为 TRUE则 n 指定增加或递减当前亮度的量。 如果 fScale 设置为 FALSE则 n 指定绝对亮度。

返回值

类型: COLORREF

返回修改后的 RGB 值。

注解

如果 fScale 设置为 TRUE,n 的范围可以是 -1000 到 +1000。

如果 fScale 设置为 FALSE则 n 的范围为 0 到 1000。 可用亮度值范围为 0 到最大值。 如果请求的值为负或超过最大值,则亮度将分别设置为零或最大值。

要求

要求
最低受支持的客户端 Windows 2000 专业版、Windows XP [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 shlwapi.h
Library Shlwapi.lib
DLL Shlwapi.dll (5.0 或更高版本)