共用方式為

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
程式庫 Shlwapi.lib
Dll Shlwapi.dll (5.0 版或更新版本)