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 から最大です。 要求された値が負の値または最大値を超える場合、輝度はそれぞれ 0 または最大値に設定されます。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional、Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー shlwapi.h
Library Shlwapi.lib
[DLL] Shlwapi.dll (バージョン 5.0 以降)