VisualBrush Класс

Определение

Пространство имен:: System.Windows.Media

Сборка:: PresentationCore.dll

Важно!

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

Рисует область с помощью Visual.

public ref class VisualBrush sealed : System::Windows::Media::TileBrush

public sealed class VisualBrush : System.Windows.Media.TileBrush

type VisualBrush = class
    inherit TileBrush

Public NotInheritable Class VisualBrush
Inherits TileBrush

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

DispatcherObject

DependencyObject

Freezable

Animatable

Brush

TileBrush
VisualBrush

Создайте новый Visual объект и используйте его для задания Visual свойства VisualBrushобъекта.
Используйте существующий Visualобъект, который создает дубликат изображения целевого объекта Visual. Затем можно использовать VisualBrush для создания интересных эффектов, таких как отражение и увеличение.

При определении нового Visual для объекта VisualBrush и Visual UIElement т. д. (например, панели или элемента управления) система макета выполняется на UIElement дочерних элементах, когда AutoLayoutContent свойству присвоено значение true. Однако корневой каталог UIElement по сути изолирован от остальной части системы; стили, раскадровки и внешний макет не могут пронизать эту границу. Таким образом, необходимо явно указать размер корневого элемента UIElement, так как его единственный родительский элемент является VisualBrush и поэтому не может автоматически изменять размер области, нарисованной. Дополнительные сведения о макете в Windows Presentation Foundation (WPF) см. в разделе "Макет".

Обновления визуального дерева не VisualBrush будут распространяться, если он BitmapEffect находится в родительской цепочке кисти. Это ограничение можно обойти, принудив обновление сцены к объекту над эффектом. Вы можете вызвать InvalidateVisual или включить анимацию для принудительного обновления сцены.

Функции, доступные для освобождения: Так как он наследует от Freezable класса, класс предоставляет несколько специальных функций: VisualBrush VisualBrush объекты можно объявлять как и совместно использовать между несколькими объектами. Дополнительные сведения о различных функциях, предоставляемых Freezable объектами, см. в обзоре объектов Freezable.

Замечание

Невозможно VisualBrush сделать доступным только для чтения (замороженным), если его Visual свойство имеет любое значение, отличное от nullзначения.

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

Имя	Описание
VisualBrush()	Инициализирует новый экземпляр класса VisualBrush.
VisualBrush(Visual)	Инициализирует новый экземпляр VisualBrush класса, содержащего указанный Visualобъект.

Поля

Имя	Описание
AutoLayoutContentProperty	Определяет AutoLayoutContent свойство зависимостей.
VisualProperty	Определяет Visual свойство зависимостей.

Свойства

Имя	Описание
AlignmentX	Возвращает или задает горизонтальное выравнивание содержимого на базовой плитке TileBrush . (Унаследовано от TileBrush)
AlignmentY	Возвращает или задает вертикальное выравнивание содержимого на базовой плитке TileBrush . (Унаследовано от TileBrush)
AutoLayoutContent	Возвращает или задает значение, указывающее, будет ли он VisualBrush выполнять макет.Visual
CanFreeze	Возвращает значение, указывающее, можно ли изменить объект. (Унаследовано от Freezable)
DependencyObjectType	Возвращает объект DependencyObjectType , который упаковывает тип СРЕДЫ CLR этого экземпляра. (Унаследовано от DependencyObject)
Dispatcher	Dispatcher Возвращает это DispatcherObject значение, с которым связано. (Унаследовано от DispatcherObject)
HasAnimatedProperties	Возвращает значение, указывающее, связан ли один или несколько AnimationClock объектов с любым из свойств зависимостей этого объекта. (Унаследовано от Animatable)
IsFrozen	Возвращает значение, указывающее, является ли объект изменяемым в настоящее время. (Унаследовано от Freezable)
IsSealed	Возвращает значение, указывающее, запечатан ли этот экземпляр (только для чтения). (Унаследовано от DependencyObject)
Opacity	Возвращает или задает степень непрозрачности объекта Brush. (Унаследовано от Brush)
RelativeTransform	Возвращает или задает преобразование, которое применяется к кисти с помощью относительных координат. (Унаследовано от Brush)
Stretch	Возвращает или задает значение, указывающее, как содержимое этого TileBrush растяжения соответствует его плиткам. (Унаследовано от TileBrush)
TileMode	Возвращает или задает значение, указывающее, как TileBrush заполняется область, которую вы рисуете, если базовая плитка меньше выходной области. (Унаследовано от TileBrush)
Transform	Возвращает или задает преобразование, которое применяется к кисти. Это преобразование применяется после того, как выходные данные кисти сопоставлены и расположены. (Унаследовано от Brush)
Viewbox	Возвращает или задает положение и размеры содержимого на плитке TileBrush . (Унаследовано от TileBrush)
ViewboxUnits	Возвращает или задает значение, указывающее, является ли Viewbox значение относительно ограничивающего поля содержимого TileBrush или является ли значение абсолютным. (Унаследовано от TileBrush)
Viewport	Возвращает или задает положение и размеры базовой плитки для объекта TileBrush. (Унаследовано от TileBrush)
ViewportUnits	Возвращает или задает BrushMappingMode перечисление, указывающее, является ли значение Viewportобъекта , указывающее размер и позицию TileBrush базовой плитки, относительно размера области вывода. (Унаследовано от TileBrush)
Visual	Возвращает или задает содержимое кисти.

Методы

Имя	Описание
ApplyAnimationClock(DependencyProperty, AnimationClock, HandoffBehavior)	Применяется к указанному объекту AnimationClock DependencyProperty. Если свойство уже анимировано, используется указанный HandoffBehavior параметр. (Унаследовано от Animatable)
ApplyAnimationClock(DependencyProperty, AnimationClock)	Применяется к указанному объекту AnimationClock DependencyProperty. Если свойство уже анимировано, 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()	Создает модификаторный клон этого VisualBrushобъекта, делая глубокие копии значений этого объекта.
CloneCore(Freezable)	Делает экземпляр клоном (глубокой копией) указанных Freezable значений свойств с использованием базовых (не анимированных) значений свойств. (Унаследовано от Freezable)
CloneCurrentValue()	Создает модификаторный клон этого объекта, делая глубокие копии текущих значений этого VisualBrush объекта. Ссылки на ресурсы, привязки данных и анимации не копируются, но их текущие значения.
CloneCurrentValueCore(Freezable)	Делает экземпляр модификируемым клоном (глубокой копией) указанного Freezable с использованием текущих значений свойств. (Унаследовано от Freezable)
CoerceValue(DependencyProperty)	Принуждает значение указанного свойства зависимостей. Это достигается путем вызова любой CoerceValueCallback функции, указанной в метаданных свойств для свойства зависимостей, так как он существует при вызове DependencyObject. (Унаследовано от DependencyObject)
CreateInstance()	Инициализирует новый экземпляр класса Freezable. (Унаследовано от Freezable)
CreateInstanceCore()	При реализации в производном классе создает новый экземпляр производного Freezable класса. (Унаследовано от Freezable)
Equals(Object)	Определяет, эквивалентен ли предоставленный DependencyObject объект текущему DependencyObject. (Унаследовано от DependencyObject)
Freeze()	Делает текущий объект неизменяемым и задает для свойства значение IsFrozen`true`. (Унаследовано от Freezable)
FreezeCore(Boolean)	Делает этот Animatable объект неизменяемым или определяет, может ли он быть изменен. (Унаследовано от Animatable)
GetAnimationBaseValue(DependencyProperty)	Возвращает неанимированное значение указанного DependencyProperty. (Унаследовано от Animatable)
GetAsFrozen()	Создает замороженную копию базовых Freezable(не анимированных) значений свойств. Так как копия заморожена, все замороженные вложенные объекты копируются по ссылке. (Унаследовано от Freezable)
GetAsFrozenCore(Freezable)	Делает экземпляр замороженным клоном указанных Freezable значений свойств (не анимированных). (Унаследовано от Freezable)
GetContentBounds(Rect)	Получает текущие границы содержимого TileBrush . (Унаследовано от TileBrush)
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)

Применяется к

Обратная связь

Были ли сведения на этой странице полезными?

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