Метод 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
Целое число, указывающее количество элементов в предустановленном массивеColors . Это то же самое, что и количество элементов в массиве blendPositions .
Возвращаемое значение
Тип: Состояние
В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .
Если метод завершается ошибкой, он возвращает один из других элементов перечисления Status .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP, Windows 2000 Профессиональная [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | gdiplusbrush.h (включая Gdiplus.h) |
| Библиотека | Gdiplus.lib |
| DLL | Gdiplus.dll |