LinearGradientBrush：：GetInterpolationColors 方法 (gdiplusbrush.h)

發行項
08/23/2023

LinearGradientBrush：：GetInterpolationColors方法會取得目前設定為此線性漸層筆刷及其對應混合位置的插補色彩。

語法

Status GetInterpolationColors(
  [out] Color *presetColors,
  [out] REAL  *blendPositions,
  [in]  INT   count
);

參數

[out] presetColors

類型：色彩*

接收色彩之陣列的指標。 presetColors陣列中指定索引的色彩會對應至blendPositions陣列中相同索引的混合位置。

[out] blendPositions

類型： REAL*

接收混合位置之陣列的指標。陣列中的每個數位都表示開始界限與結束界限之間的距離百分比，而且介於 0.0 到 1.0 之間，其中 0.0 表示漸層的起始界限，而 1.0 表示結束界限。介於 0.0 和 1.0 之間的混合位置表示與界限線平行的線條，這是從開始界限到結束界限之間的特定距離分數。例如，0.7 的混合位置表示距離從開始界限到結束界限的距離 70%。色彩在與界限線平行的線條上是常數。

[in] count

類型： INT

整數，指定 presetColors 陣列中的專案數目。這與 blendPositions 陣列中的元素數目相同。呼叫LinearGradientBrush：：GetInterpolationColors方法的LinearGradientBrush物件之前，請先呼叫相同LinearGradientBrush：：GetInterpolationColorCount方法，以判斷目前的色彩數目。擷取的混合位置數目與擷取的色彩數目相同。

傳回值

類型：狀態

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

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

需求


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