共用方式為


LinearGradientBrush::SetInterpolationColors 方法 (gdiplusbrush.h)

LinearGradientBrush::SetInterpolationColors 方法會將此線性漸層筆刷及其對應混合位置的色彩設定為插補。

語法

Status SetInterpolationColors(
  [in] const Color *presetColors,
  [in] const REAL  *blendPositions,
  [in] INT         count
);

參數

[in] presetColors

類型: const Color*

Color 物件的陣列 指標,指定要插入這個線性漸層筆刷的色彩。 presetColors 陣列中指定索引的色彩會對應至 blendPositions 陣列中相同索引的混合位置。

[in] blendPositions

類型: const REAL*

指定混合位置之實數陣列的指標。 陣列中的每個數位都會指定開始界限與結束界限之間的距離百分比,而且介於0.0到1.0之間,其中0.0表示漸層的起始界限,而1.0表示結束界限。 至少必須指定兩個位置:第一個位置,一律為0.0f,最後一個位置一律為1.0f。 否則,行為是未定義的。 介於 0.0 和 1.0 之間的混合位置表示與界限線平行的線條,這是從開始界限到結束界限之間的特定距離分數。 例如,0.7 的混合位置表示距離從開始界限到結束界限的距離 70%。 色彩在與界限線平行的線條上是常數。

[in] count

類型: INT

整數,指定 presetColors 陣列中的項目數目。 這與 blendPositions 陣列中的元素數目相同。

傳回值

類型: 狀態

如果方法成功,它會傳回Ok,這是 Status 列舉的元素。

如果方法失敗,它會傳回 Status 列舉的其他其中一個專案。

規格需求

需求
最低支援的用戶端 Windows XP、Windows 2000 Professional [僅限桌面應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 gdiplusbrush.h (包含 Gdiplus.h)
程式庫 Gdiplus.lib
Dll Gdiplus.dll

另請參閱

筆刷和填滿的圖形

色彩

建立線性漸層

使用色彩漸層填滿圖形

LinearGradientBrush \(英文\)

LinearGradientBrush::GetInterpolationColors