Интерфейс IXpsOMGradientBrush (xpsobjectmodel.h)
Этот интерфейс описывает градиент, состоящий из остановок градиента. Классы, наследующие от IXpsOMGradientBrush , указывают различные способы интерпретации остановок градиента.
IXpsOMGradientBrush — это базовый интерфейс для интерфейсов IXpsOMLinearGradientBrush и IXpsOMRadialGradientBrush .
Наследование
Интерфейс IXpsOMGradientBrush наследуется от IXpsOMBrush. IXpsOMGradientBrush также имеет следующие типы членов:
Методы
Интерфейс IXpsOMGradientBrush содержит следующие методы.
| IXpsOMGradientBrush::GetColorInterpolationMode Возвращает гамма-функцию, используемую для интерполяции цвета. |
| IXpsOMGradientBrush::GetGradientStops Получает указатель на интерфейс IXpsOMGradientStopCollection, содержащий коллекцию интерфейсов IXpsOMGradientStop, определяющих градиент. |
| IXpsOMGradientBrush::GetSpreadMethod Возвращает значение XPS_SPREAD_METHOD, описывающее, как будет отображаться область за пределами области градиента. |
| IXpsOMGradientBrush::GetTransform Возвращает указатель на интерфейс IXpsOMMatrixTransform, содержащий разрешенное матричное преобразование для кисти. (IXpsOMGradientBrush.GetTransform) |
| IXpsOMGradientBrush::GetTransformLocal Возвращает указатель на интерфейс IXpsOMMatrixTransform, который содержит локальное, неразрешимое преобразование матрицы без общего доступа для кисти. |
| IXpsOMGradientBrush::GetTransformLookup Возвращает имя ключа поиска общего интерфейса преобразования матрицы, который будет использоваться для кисти. |
| IXpsOMGradientBrush::SetColorInterpolationMode Задает значение XPS_COLOR_INTERPOLATION, которое описывает гамма-функцию, используемую для интерполяции цвета. |
| IXpsOMGradientBrush::SetSpreadMethod Задает значение XPS_SPREAD_METHOD, описывающее отрисовку области за пределами области градиента. |
| IXpsOMGradientBrush::SetTransformLocal Задает указатель интерфейса IXpsOMMatrixTransform на локальное преобразование матрицы без общего доступа, которое будет использоваться для кисти. |
| IXpsOMGradientBrush::SetTransformLookup Задает имя ключа подстановки общего преобразования матрицы, которое будет использоваться для кисти. |
Комментарии
Методы этого интерфейса определяют основные параметры градиента. Тип градиента, который может быть линейным или радиальным, определяет способ применения этих параметров.
Как показано на рисунке ниже, начальная и конечная точки линейного градиента помечают конечные точки пути градиента. Путь градиента — это прямая линия, соединяющая начальную и конечную точки. Область градиента линейного градиента состоит из области между начальной и конечной точками, включая эти точки, и простирается в обоих направлениях под прямым углом к пути градиента. Область распространения — это область за пределами области градиента.
Градиентные остановки определяют цвет в определенных местах вдоль пути градиента; цвет интерполируется по пути градиента между его остановками, как показано на следующем рисунке.
Как показано на рисунке ниже, область градиента радиального градиента представляет собой область, заключенную в эллипс, который описывается центральной точкой и радиусами x и y, которые простираются от центральной точки. Область распространения — это область за пределами этого эллипса. Путь градиента представляет собой радиальную линию, которая выполняет очистку всей области градиента от источника градиента до эллипса, ограничивающего область градиента. На следующем рисунке путь градиента не показан.
Метод spread описывает, как заполняется область распространения. Реализация метода spread зависит от типа градиента (линейного или радиального). На следующем рисунке показано несколько примеров заполнения области распределения. Сведения о различных методах распространения см. в разделе XPS_SPREAD_METHOD.
Преобразование определяет, как преобразуется результирующий градиент. Видимая часть градиента, которая в конечном итоге отображается на изображении, определяется путем, штрихом или глифом, использующим градиентную кисть.
Требования
| Минимальная версия клиента | Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновлением платформы для Windows Vista [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | xpsobjectmodel.h |