Brush Класс

Определение

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

Windows.UI.Xaml.Media

Определяет объекты, которые используются для заливки графических объектов. Классы, производные от Brush, описывают, как закрашена область.

public ref class Brush : DependencyObject, IAnimationObject

/// [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)]
class Brush : DependencyObject, IAnimationObject

[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)]
public class Brush : DependencyObject, IAnimationObject

Public Class Brush
Inherits DependencyObject
Implements IAnimationObject

<object property="predefinedColorName"/>
- or -
<object property="#rgb"/>
- or -
<object property="#argb"/>
- or -
<object property="#rrggbb"/>
- or -
<object property="#aarrggbb"/>
- or -
<object property="sc#scR,scG,scB"/>
- or -
<object property="sc#scA,scR,scG,scB"/>

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

Object Platform::Object IInspectable DependencyObject Brush

Производный

Windows.UI.Xaml.Media.GradientBrush

Windows.UI.Xaml.Media.SolidColorBrush

Windows.UI.Xaml.Media.TileBrush

Windows.UI.Xaml.Media.XamlCompositionBrushBase

Атрибуты

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Реализации

IAnimationObject

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

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

Комментарии

Примеры и дополнительные объяснения концепций рисования пользовательского интерфейса, представленных Brush, см. в разделе Использование кистей.

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

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

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

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

Классы, производные от кисти

Brush — это родительский класс для нескольких производных классов, которые либо реализуют практические кисти, которые рисуют области пользовательского интерфейса, либо являются промежуточными базовыми классами для таких кистей:

• GradientBrush: промежуточный базовый класс для LinearGradientBrush.
• SolidColorBrush: это наиболее часто используемая кисть.
• TileBrush: промежуточный базовый класс для ImageBrush.

Журнал версий

Версия Windows	Версия пакета SDK	Добавленная стоимость
1809	17763	ЗаполнениеPropertyInfo
1809	17763	ЗаполнениеPropertyInfoOverride

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

Brush()

Обеспечивает поведение инициализации базового класса для классов, производных от Brush.

Свойства

Dispatcher	Возвращает CoreDispatcher , с которым связан этот объект. CoreDispatcher представляет средство, которое может получить доступ к DependencyObject в потоке пользовательского интерфейса, даже если код инициируется потоком, не относящегося к пользовательскому интерфейсу. (Унаследовано от DependencyObject)
Opacity	Возвращает или задает степень непрозрачности кисти.
OpacityProperty	Идентифицирует свойство зависимости Opacity .
RelativeTransform	Возвращает или задает преобразование, которое применяется к кисти с использованием относительных координат.
RelativeTransformProperty	Определяет свойство зависимости RelativeTransform .
Transform	Получает или задает преобразование, которое применяется к кисти.
TransformProperty	Идентифицирует свойство зависимостей Transform .

Методы

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

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

• DependencyObject
• SolidColorBrush
• Color
• Colors
• Использование кистей
• Изображения и кисти изображений
• Ссылки на ресурсы ResourceDictionary и XAML