LinearGradientBrush Класс

Определение

Пространство имен:

Windows.UI.Xaml.Media

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

public ref class LinearGradientBrush sealed : GradientBrush

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.Xaml.Media.ILinearGradientBrushFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class LinearGradientBrush final : GradientBrush

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.Xaml.Media.ILinearGradientBrushFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class LinearGradientBrush : GradientBrush

Public NotInheritable Class LinearGradientBrush
Inherits GradientBrush

<LinearGradientBrush ...>
  oneOrMoreGradientStops
</LinearGradientBrush

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

Object Platform::Object IInspectable DependencyObject Brush GradientBrush LinearGradientBrush

Атрибуты

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Требования к Windows

Семейство устройств	Windows 10 (появилось в 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (появилось в v1.0)

Примеры

В следующем примере создается линейный градиент из четырех цветов, а затем им закрашивается объект Rectangle.

<StackPanel>
  <!-- This rectangle is painted with a vertical linear gradient. -->
  <Rectangle Width="200" Height="100">
    <Rectangle.Fill>
      <LinearGradientBrush StartPoint="0.5,0" EndPoint="0.5,1">
        <GradientStop Color="Yellow" Offset="0.0" />
        <GradientStop Color="Red" Offset="0.25" />
        <GradientStop Color="Blue" Offset="0.75" />
        <GradientStop Color="LimeGreen" Offset="1.0" />
      </LinearGradientBrush>
    </Rectangle.Fill>
  </Rectangle>
</StackPanel>

Комментарии

LinearGradientBrush — это тип Brush , который используется для многих возможных свойств пользовательского интерфейса, которые используют кисть для заполнения части или всей визуальной области объекта в пользовательском интерфейсе приложения. Примеры некоторых наиболее часто используемых свойств, использующих значение кисти : Control.Background, Control.Foreground, Shape.Fill, Control.BorderBrush, Panel.Background, TextBlock.Foreground. LinearGradientBrush является альтернативой более часто используемому типу SolidColorBrush .

Свойства StartPoint и EndPoint объектов LinearGradientBrush описывают две точки в относительном пространстве координат. Это создает ориентацию для градиента и обычно задает горизонтальный или вертикальный градиент. Также можно использовать диагональный градиент. LinearGradientBrush обычно имеет два или более значений GradientStop для свойства GradientStops (упорядоченной коллекции). Каждый параметр GradientStop задает цвет и смещение. Смещение представляет позицию между 0 ( Начальная точка) и 1 ( Конечная точка) вдоль градиента, а фактическая длина пикселя кисти и ее градиента корректируются в зависимости от пользовательского интерфейса, в котором вы применяете LinearGradientBrush в качестве значения. Дополнительные сведения о том, как определяются значения Offset и как связаны offset, StartPoint и EndPoint , см. в разделе Использование кистей. Это часто используется

Значение Transparent можно использовать для одного из цветов GradientStop . Хотя это визуально не применяет никаких изменений к пользовательскому интерфейсу (это прозрачно), эта точка может быть обнаружена в целях проверки попадания. Дополнительные сведения о тестировании нажатия см. в разделе "Проверка нажатия" статьи Взаимодействие с мышью.

Значения GradientStop объекта LinearGradientBrush можно анимировать как часть переходов или декоративных анимаций. Используйте один из выделенных типов анимации, которые могут анимировать значение Color . Обычно для этого требуется .(GradientStop.Color) быть частью более длинного пути свойства для значения Storyboard.TargetProperty . Дополнительные сведения о выборе свойств и о том, как анимировать свойства, использующие значения кисти , см. в разделе Раскадровка анимации.

Кисти как ресурсы XAML

Каждый из типов кистей , которые можно объявить в XAML (SolidColorBrush, LinearGradientBrush, ImageBrush), предназначен для определения как ресурса, чтобы вы могли повторно использовать эту кисть в качестве ресурса во всем приложении. Синтаксис XAML, показанный для типов кистей , подходит для определения кисти как ресурса. При объявлении кисти в качестве ресурса также требуется атрибут x:Key , который позже будет использоваться для ссылки на этот ресурс из других определений пользовательского интерфейса. Дополнительные сведения о ресурсах XAML и использовании атрибута x:Key см. в статье Справочник по ресурсам ResourceDictionary и XAML.

Преимущество объявления кистей как ресурсов заключается в сокращении количества объектов среды выполнения, необходимых для создания пользовательского интерфейса. Теперь кисть используется как общий ресурс, предоставляющий значения для нескольких частей графа объектов.

Если вы посмотрите на существующие определения шаблонов элементов управления для среда выполнения Windows элементов управления XAML, вы увидите, что шаблоны широко используют ресурсы кисти (хотя обычно это SolidColorBrush, а не LinearGradientBrush). Многие из этих ресурсов являются системными, и они используют расширение разметки {ThemeResource} для ссылки на ресурс, а не расширение разметки {StaticResource}. Дополнительные сведения об использовании кистей системных ресурсов в собственном шаблоне элемента управления XAML см. в разделе Ресурсы темы XAML.

Конструкторы

LinearGradientBrush()	Инициализирует новый экземпляр класса LinearGradientBrush .
LinearGradientBrush(GradientStopCollection, Double)	Инициализирует новый экземпляр класса LinearGradientBrush , имеющий указанные GradientStopCollection и угол.

Свойства

ColorInterpolationMode	Возвращает или задает значение перечисления ColorInterpolationMode , указывающее способ интерполяции цветов градиента. (Унаследовано от GradientBrush)
Dispatcher	Возвращает CoreDispatcher , с которым связан этот объект. CoreDispatcher представляет средство, которое может получить доступ к DependencyObject в потоке пользовательского интерфейса, даже если код инициируется потоком, не относящегося к пользовательскому интерфейсу. (Унаследовано от DependencyObject)
EndPoint	Получает или задает конечные двумерные координаты для линейного градиента.
EndPointProperty	Определяет свойство зависимости EndPoint .
GradientStops	Получает или задает ограничения градиента кисти. (Унаследовано от GradientBrush)
MappingMode	Возвращает или задает значение перечисления BrushMappingMode , указывающее, являются ли координаты положения градиентной кисти абсолютными или относительно области вывода. (Унаследовано от GradientBrush)
Opacity	Возвращает или задает степень непрозрачности кисти. (Унаследовано от Brush)
RelativeTransform	Возвращает или задает преобразование, которое применяется к кисти с использованием относительных координат. (Унаследовано от Brush)
SpreadMethod	Получение или установка типа метода распределения, задающего способ рисования градиента, начинающегося или заканчивающегося в границах закрашиваемого объекта. (Унаследовано от GradientBrush)
StartPoint	Получает или устанавливает начальные двумерные координаты для линейного градиента.
StartPointProperty	Определяет свойство зависимости StartPoint .
Transform	Получает или задает преобразование, которое применяется к кисти. (Унаследовано от Brush)

Методы

ClearValue(DependencyProperty)	Очищает локальное значение свойства зависимостей. (Унаследовано от DependencyObject)
GetAnimationBaseValue(DependencyProperty)	Возвращает любое базовое значение, установленное для свойства зависимостей, которое применяется в случаях, когда анимация не активна. (Унаследовано от DependencyObject)
GetValue(DependencyProperty)	Возвращает текущее действующее значение свойства зависимостей из DependencyObject. (Унаследовано от DependencyObject)
PopulatePropertyInfo(String, AnimationPropertyInfo)	Определяет свойство, которое можно анимировать. (Унаследовано от Brush)
PopulatePropertyInfoOverride(String, AnimationPropertyInfo)	При переопределении в производном классе определяет свойство, которое можно анимировать. (Унаследовано от Brush)
ReadLocalValue(DependencyProperty)	Возвращает локальное значение свойства зависимостей, если задано локальное значение. (Унаследовано от DependencyObject)
RegisterPropertyChangedCallback(DependencyProperty, DependencyPropertyChangedCallback)	Регистрирует функцию уведомления для прослушивания изменений определенной DependencyProperty в этом экземпляре DependencyObject . (Унаследовано от DependencyObject)
SetValue(DependencyProperty, Object)	Задает локальное значение свойства зависимостей для Объекта DependencyObject. (Унаследовано от DependencyObject)
UnregisterPropertyChangedCallback(DependencyProperty, Int64)	Отменяет уведомление об изменениях, которое было ранее зарегистрировано путем вызова метода RegisterPropertyChangedCallback. (Унаследовано от DependencyObject)

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

• GradientBrush
• SolidColorBrush
• RadialGradientBrush.
• Использование кистей
• Ссылки на ресурсы ResourceDictionary и XAML