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 \(英文\)