Метод 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 того же объекта LinearGradientBrush , чтобы определить текущее количество цветов. Количество полученных позиций наложения совпадает с количеством полученных цветов.

Возвращаемое значение

Тип: Состояние

В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .

Если метод завершается сбоем, он возвращает один из других элементов перечисления Status .

Требования


Минимальная версия клиента	Windows XP, Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	gdiplusbrush.h (включая Gdiplus.h)
Библиотека	Gdiplus.lib
DLL	Gdiplus.dll