RadialGradientBrush Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Красит область с радиальным градиентом. Фокус определяет начало градиента, а круг определяет конечную точку градиента.
public ref class RadialGradientBrush sealed : System::Windows::Media::GradientBrush
public sealed class RadialGradientBrush : System.Windows.Media.GradientBrush
type RadialGradientBrush = class
inherit GradientBrush
Public NotInheritable Class RadialGradientBrush
Inherits GradientBrush
- Наследование
-
RadialGradientBrush
Комментарии
Аналогичен RadialGradientBrush модели программирования с моделью LinearGradientBrushпрограммирования. Однако линейный градиент имеет начальную и конечную точку для определения вектора градиента, в то время как радиальный градиент имеет круг вместе с фокусной точкой для определения поведения градиента. Круг определяет конечную точку градиента. Другими словами, градиентная остановка в 1.0 определяет цвет в окружности круга. Фокус определяет центр градиента. Градиентная остановка в 0.0 определяет цвет в фокусной точке.
На следующем рисунке показан прямоугольник, заполненный радиальным градиентом. Радиальный градиент, который идет от белого до серого. Внешний круг представляет градиентный круг, а красная точка обозначает фокус. Этот градиент имеет значение SpreadMethodPad.
Радиальный градиент с выделенной фокусной точкой
Note
RadialGradientBrush объекты отрисовываются с помощью аппаратного ускорения в Tier 2 системах. Дополнительные сведения о уровнях оборудования см. в разделе "Уровни отрисовки графики".
Бесплатные функции
Так как он наследует от Freezable класса, класс предоставляет несколько специальных функций: RadialGradientBrushRadialGradientBrush объекты могут быть объявлены как ресурсы, общие для нескольких объектов, доступные только для чтения, для повышения производительности, клонированного и безопасного потока. Дополнительные сведения о различных функциях, предоставляемых Freezable объектами, см. в обзоре объектов Freezable.
Конструкторы
| Имя | Описание |
|---|---|
| RadialGradientBrush() |
Инициализирует новый экземпляр класса RadialGradientBrush. |
| RadialGradientBrush(Color, Color) |
Инициализирует новый экземпляр RadialGradientBrush класса с указанными цветами начала и остановки. |
| RadialGradientBrush(GradientStopCollection) |
Инициализирует новый экземпляр RadialGradientBrush класса с указанными остановками градиента. |
Поля
| Имя | Описание |
|---|---|
| CenterProperty |
Определяет Center свойство зависимостей. |
| GradientOriginProperty |
Определяет GradientOrigin свойство зависимостей. |
| RadiusXProperty |
Определяет RadiusX свойство зависимостей. |
| RadiusYProperty |
Определяет RadiusY свойство зависимостей. |
Свойства
| Имя | Описание |
|---|---|
| CanFreeze |
Возвращает значение, указывающее, можно ли изменить объект. (Унаследовано от Freezable) |
| Center |
Возвращает или задает центр самого внешнего круга радиального градиента. |
| ColorInterpolationMode |
Возвращает или задает перечисление ColorInterpolationMode , указывающее, как интерполируются цвета градиента. (Унаследовано от GradientBrush) |
| DependencyObjectType |
Возвращает объект DependencyObjectType , который упаковывает тип СРЕДЫ CLR этого экземпляра. (Унаследовано от DependencyObject) |
| Dispatcher |
Dispatcher Возвращает это DispatcherObject значение, с которым связано. (Унаследовано от DispatcherObject) |
| GradientOrigin |
Возвращает или задает расположение двухмерной фокусной точки, определяющей начало градиента. |
| GradientStops |
Возвращает или задает градиентные остановки кисти. (Унаследовано от GradientBrush) |
| HasAnimatedProperties |
Возвращает значение, указывающее, связан ли один или несколько AnimationClock объектов с любым из свойств зависимостей этого объекта. (Унаследовано от Animatable) |
| IsFrozen |
Возвращает значение, указывающее, является ли объект изменяемым в настоящее время. (Унаследовано от Freezable) |
| IsSealed |
Возвращает значение, указывающее, запечатан ли этот экземпляр (только для чтения). (Унаследовано от DependencyObject) |
| MappingMode |
Возвращает или задает перечисление BrushMappingMode , указывающее, являются ли координаты расположения кисти градиентной кистью абсолютными или относительными к выходной области. (Унаследовано от GradientBrush) |
| Opacity |
Возвращает или задает степень непрозрачности объекта Brush. (Унаследовано от Brush) |
| RadiusX |
Возвращает или задает горизонтальный радиус самого внешнего круга радиального градиента. |
| RadiusY |
Возвращает или задает вертикальный радиус самого внешнего круга радиального градиента. |
| RelativeTransform |
Возвращает или задает преобразование, которое применяется к кисти с помощью относительных координат. (Унаследовано от Brush) |
| SpreadMethod |
Возвращает или задает тип метода распространения, который указывает, как нарисовать градиент, который начинается или заканчивается внутри границ объекта, который должен быть окрашен. (Унаследовано от GradientBrush) |
| Transform |
Возвращает или задает преобразование, которое применяется к кисти. Это преобразование применяется после того, как выходные данные кисти сопоставлены и расположены. (Унаследовано от Brush) |
Методы
| Имя | Описание |
|---|---|
| ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior) |
Применяется к указанному объекту AnimationClockDependencyProperty. Если свойство уже анимировано, используется указанный HandoffBehavior параметр. (Унаследовано от Animatable) |
| ApplyAnimationClock(DependencyProperty, AnimationClock) |
Применяется к указанному объекту AnimationClockDependencyProperty. Если свойство уже анимировано, SnapshotAndReplace используется поведение передачи. (Унаследовано от Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline, HandoffBehavior) |
Применяет анимацию к указанному DependencyProperty. Анимация запускается при отрисовки следующего кадра. Если указанное свойство уже анимировано, используется указанный HandoffBehavior параметр. (Унаследовано от Animatable) |
| BeginAnimation(DependencyProperty, AnimationTimeline) |
Применяет анимацию к указанному DependencyProperty. Анимация запускается при отрисовки следующего кадра. Если указанное свойство уже анимировано, SnapshotAndReplace используется поведение передачи. (Унаследовано от Animatable) |
| CheckAccess() |
Определяет, имеет ли вызывающий поток доступ к этому DispatcherObject. (Унаследовано от DispatcherObject) |
| ClearValue(DependencyProperty) |
Очищает локальное значение свойства. Свойство для очистки указывается идентификатором DependencyProperty . (Унаследовано от DependencyObject) |
| ClearValue(DependencyPropertyKey) |
Очищает локальное значение свойства только для чтения. Свойство, которое необходимо очистить, задается параметром DependencyPropertyKey. (Унаследовано от DependencyObject) |
| Clone() |
Создает модификаторный клон этого RadialGradientBrushобъекта, делая глубокие копии значений этого объекта. При копировании свойств зависимостей этот метод копирует ссылки на ресурсы и привязки данных (но они больше не могут разрешаться), но не анимации или их текущие значения. |
| CloneCore(Freezable) |
Делает экземпляр клоном (глубокой копией) указанных Freezable значений свойств с использованием базовых (не анимированных) значений свойств. (Унаследовано от Freezable) |
| CloneCurrentValue() |
Создает модификаторный клон этого объекта, делая глубокие копии текущих значений этого RadialGradientBrush объекта. Ссылки на ресурсы, привязки данных и анимации не копируются, но их текущие значения. |
| CloneCurrentValueCore(Freezable) |
Делает экземпляр модификируемым клоном (глубокой копией) указанного Freezable с использованием текущих значений свойств. (Унаследовано от Freezable) |
| CoerceValue(DependencyProperty) |
Принуждает значение указанного свойства зависимостей. Это достигается путем вызова любой CoerceValueCallback функции, указанной в метаданных свойств для свойства зависимостей, так как он существует при вызове DependencyObject. (Унаследовано от DependencyObject) |
| CreateInstance() |
Инициализирует новый экземпляр класса Freezable. (Унаследовано от Freezable) |
| CreateInstanceCore() |
При реализации в производном классе создает новый экземпляр производного Freezable класса. (Унаследовано от Freezable) |
| Equals(Object) |
Определяет, эквивалентен ли предоставленный DependencyObject объект текущему DependencyObject. (Унаследовано от DependencyObject) |
| Freeze() |
Делает текущий объект неизменяемым и задает для свойства значение IsFrozen |
| FreezeCore(Boolean) |
Делает этот Animatable объект неизменяемым или определяет, может ли он быть изменен. (Унаследовано от Animatable) |
| GetAnimationBaseValue(DependencyProperty) |
Возвращает неанимированное значение указанного DependencyProperty. (Унаследовано от Animatable) |
| GetAsFrozen() |
Создает замороженную копию базовых Freezable(не анимированных) значений свойств. Так как копия заморожена, все замороженные вложенные объекты копируются по ссылке. (Унаследовано от Freezable) |
| GetAsFrozenCore(Freezable) |
Делает экземпляр замороженным клоном указанных Freezable значений свойств (не анимированных). (Унаследовано от Freezable) |
| GetCurrentValueAsFrozen() |
Создает замороженную копию с использованием текущих значений Freezable свойств. Так как копия заморожена, все замороженные вложенные объекты копируются по ссылке. (Унаследовано от Freezable) |
| GetCurrentValueAsFrozenCore(Freezable) |
Делает текущий экземпляр замороженным клоном указанного Freezable. Если объект имеет анимированные свойства зависимостей, их текущие анимированные значения копируются. (Унаследовано от Freezable) |
| GetHashCode() |
Получает хэш-код для этого DependencyObject. (Унаследовано от DependencyObject) |
| GetLocalValueEnumerator() |
Создает специализированный перечислитель для определения того, какие свойства зависимостей имеют локальные значения для этого DependencyObject. (Унаследовано от DependencyObject) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| GetValue(DependencyProperty) |
Возвращает текущее эффективное значение свойства зависимостей для этого экземпляра DependencyObject. (Унаследовано от DependencyObject) |
| InvalidateProperty(DependencyProperty) |
Повторно вычисляет эффективное значение для указанного свойства зависимостей. (Унаследовано от DependencyObject) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| OnChanged() |
Вызывается при изменении текущего Freezable объекта. (Унаследовано от Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject, DependencyProperty) |
Этот член поддерживает инфраструктуру Windows Presentation Foundation (WPF) и не предназначен для использования непосредственно из кода. (Унаследовано от Freezable) |
| OnFreezablePropertyChanged(DependencyObject, DependencyObject) |
Убедитесь, что для элемента данных, который только что был установлен, установлены DependencyObjectType соответствующие указатели контекста. (Унаследовано от Freezable) |
| OnPropertyChanged(DependencyPropertyChangedEventArgs) |
Переопределяет DependencyObject реализацию OnPropertyChanged(DependencyPropertyChangedEventArgs) для вызова всех Changed обработчиков в ответ на изменение свойства зависимостей типа Freezable. (Унаследовано от Freezable) |
| ReadLocalValue(DependencyProperty) |
Возвращает локальное значение свойства зависимостей, если оно существует. (Унаследовано от DependencyObject) |
| ReadPreamble() |
Гарантирует, что Freezable доступ к ней осуществляется из допустимого потока. Наследующие метод Freezable должны вызывать этот метод в начале любого API, который считывает элементы данных, которые не являются свойствами зависимостей. (Унаследовано от Freezable) |
| SetCurrentValue(DependencyProperty, Object) |
Задает значение свойства зависимостей, не изменяя его источник значений. (Унаследовано от DependencyObject) |
| SetValue(DependencyProperty, Object) |
Задает локальное значение свойства зависимостей, указанное его идентификатором свойства зависимостей. (Унаследовано от DependencyObject) |
| SetValue(DependencyPropertyKey, Object) |
Задает локальное значение свойства зависимостей только для чтения, указанное DependencyPropertyKey идентификатором свойства зависимости. (Унаследовано от DependencyObject) |
| ShouldSerializeProperty(DependencyProperty) |
Возвращает значение, указывающее, должны ли процессы сериализации сериализовать значение для указанного свойства зависимостей. (Унаследовано от DependencyObject) |
| ToString() |
Возвращает строковое представление этого Brushобъекта. (Унаследовано от Brush) |
| ToString(IFormatProvider) |
Создает строковое представление этого объекта на основе указанных сведений о форматировании, зависящих от языка и региональных параметров. (Унаследовано от Brush) |
| VerifyAccess() |
Принудительно применяет, что вызывающий поток имеет доступ к этому DispatcherObject. (Унаследовано от DispatcherObject) |
| WritePostscript() |
Changed Вызывает событие для Freezable метода и вызывает его OnChanged() метод. Классы, производные от Freezable этого метода, должны вызываться в конце любого API, который изменяет элементы класса, которые не хранятся в качестве свойств зависимостей. (Унаследовано от Freezable) |
| WritePreamble() |
Проверяет, что Freezable он не заморожен и к нему осуществляется доступ из допустимого контекста потоков. Freezable наследующие метод должны вызывать этот метод в начале любого API, записывающего элементы данных, которые не являются свойствами зависимостей. (Унаследовано от Freezable) |
События
| Имя | Описание |
|---|---|
| Changed |
Происходит при Freezable изменении объекта или объекта, содержащего его. (Унаследовано от Freezable) |
Явные реализации интерфейса
| Имя | Описание |
|---|---|
| IFormattable.ToString(String, IFormatProvider) |
Форматирует значение текущего экземпляра с помощью указанного формата. (Унаследовано от Brush) |