Brush Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Определяет объекты, которые используются для заливки графических объектов. Классы, производные от Brush, описывают, как закрашивается область.
public ref class Brush : DependencyObject, IAnimationObject/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 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(Microsoft.UI.Xaml.WinUIContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Brush : DependencyObject, IAnimationObjectPublic 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"/>
- Наследование
- Производный
- Атрибуты
- Реализации
Комментарии
Примеры и дальнейшее объяснение концепций рисования пользовательского интерфейса, представленных Brush, см. в разделе кисти XAML.
Кисти как ресурсы XAML
Типы Brush, которые можно объявить в XAML (например , SolidColorBrush, LinearGradientBrush и ImageBrush), должны быть определены как ресурс, чтобы их можно было легко повторно использовать в приложении. Синтаксис XAML, показанный для типов кистей, подходит для определения кисти в качестве ресурса. При объявлении кисти в качестве ресурса также требуется атрибут x:Key , который позже будет использоваться для ссылки на этот ресурс из других определений пользовательского интерфейса. Дополнительные сведения о ресурсах XAML и использовании атрибута x:Key см. в разделе Ссылки на ресурсы ResourceDictionary и XAML.
Преимущество объявления кистей в качестве ресурсов заключается в том, что оно сокращает количество объектов среды выполнения, необходимых для создания пользовательского интерфейса. Теперь кисть является общим ресурсом, предоставляющим значения для нескольких частей графа объектов.
Если вы посмотрите на существующие определения шаблонов элементов управления для среда выполнения Windows элементов управления XAML, вы увидите, что шаблоны широко используют ресурсы кистей. Многие из этих ресурсов являются системными и используют расширение разметки {ThemeResource} для ссылки на ресурс, а не расширение разметки {StaticResource}. Дополнительные сведения об использовании кистей системных ресурсов в XAML-коде шаблона элемента управления см. в разделе Ресурсы темы XAML.
Классы, производные от кисти
Brush — это родительский класс для нескольких производных классов, которые либо реализуют практические кисти, которые рисуют области пользовательского интерфейса, либо являются промежуточными базовыми классами для таких кистей:
- GradientBrush: промежуточный базовый класс для LinearGradientBrush.
- SolidColorBrush: это наиболее часто используемая кисть.
- TileBrush: промежуточный базовый класс для ImageBrush.
Конструкторы
| Brush() |
Обеспечивает поведение инициализации базового класса для классов, производных от Brush. |
Свойства
| Dispatcher |
Всегда возвращает в |
| DispatcherQueue |
Возвращает объект , |
| 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) |