Поделиться через


Интерфейс ID2D1LinearGradientBrush (d2d1.h)

Закрашивает область с линейным градиентом

Наследование

Интерфейс ID2D1LinearGradientBrush наследуется от ID2D1Brush. ID2D1LinearGradientBrush также имеет следующие типы элементов:

Методы

Интерфейс ID2D1LinearGradientBrush содержит следующие методы.

 
ID2D1LinearGradientBrush::GetEndPoint

Извлекает конечные координаты линейного градиента.
ID2D1LinearGradientBrush::GetGradientStopCollection

Извлекает id2D1GradientStopCollection, связанный с этой кистью линейного градиента.
ID2D1LinearGradientBrush::GetStartPoint

Получает начальные координаты линейного градиента.
ID2D1LinearGradientBrush::SetEndPoint

Задает конечные координаты линейного градиента в пространстве координат кисти.
ID2D1LinearGradientBrush::SetStartPoint

Задает начальные координаты линейного градиента в пространстве координат кисти.

Комментарии

ID2D1LinearGradientBrush закрашивает область с линейным градиентом вдоль линии между начальной и конечной точками кисти. Градиент, определенный кистью ID2D1GradientStopCollection, экструдируется перпендикулярно этой строке, а затем преобразуется преобразованием кисти (если указано).

Начальная и конечная точки описываются в пространстве кисти и сопоставляются с целевым объектом отрисовки при использовании кисти. Обратите внимание, что начальная и конечная координаты являются абсолютными, а не относительно размера целевого объекта отрисовки. Значение (0, 0) сопоставляется с левым верхним углом целевого объекта отрисовки, а значение (1, 1) сопоставляет один пиксель по диагонали от (0, 0). Если имеется преобразование кисти неидентентности или преобразование целевого объекта отрисовки, то также преобразуются начальная и конечная точка кисти.

Можно указать ось градиента, которая не полностью заполняет закрашиваемую область. В этом случае D2D1_EXTEND_MODE, заданный id2D1GradientStopCollection, определяет, как закрашивается оставшаяся область.

Создание объектов ID2D1LinearGradientBrush

Чтобы создать кисть линейного градиента, используйте метод ID2D1RenderTarget::CreateLinearGradientBrush целевого объекта отрисовки, в котором будет использоваться кисть. Кисть можно использовать только с целевым объектом отрисовки, который ее создал, или с совместимыми целевыми объектами для этого целевого объекта отрисовки.

Кисть линейного градиента — это ресурс, зависящий от устройства. Приложение должно создавать линейные градиентные кисти после инициализации целевого объекта отрисовки, с помощью которого будут использоваться кисти, и повторно создавать кисти, когда нужно воссоздать целевой объект отрисовки. (Дополнительные сведения о ресурсах см. в разделе Общие сведения о ресурсах.)

Требования

   
Минимальная версия клиента Windows 7, Windows Vista с пакетом обновления 2 (SP2) и обновлением платформы для Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header d2d1.h

См. также раздел

ID2D1Brush