VisualBrush.Visual Свойство

Определение

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

System.Windows.Media

Сборка:

PresentationCore.dll

Получает или задает содержимое кисти.

public:
 property System::Windows::Media::Visual ^ Visual { System::Windows::Media::Visual ^ get(); void set(System::Windows::Media::Visual ^ value); };

public System.Windows.Media.Visual Visual { get; set; }

member this.Visual : System.Windows.Media.Visual with get, set

Public Property Visual As Visual

Значение свойства

Visual

Содержимое кисти. Значение по умолчанию — null.

Комментарии

Содержимое Visual кисти VisualBrush можно указать двумя способами.

• Создайте новый объект Visual и используйте его для задания свойства Visual кисти VisualBrush.

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

Visual является довольно высоким в общей иерархии классов WPF, поэтому очень большое количество объектов может служить визуальным элементом, используемым для a VisualBrush; весь список не может отображаться здесь. См Visual. раздел "Иерархия наследования", в котором будут показаны сразу производные классы. Затем можно щелкнуть сразу производные классы и перейти к иерархиям, чтобы получить представление о полном спектре возможностей. На верхнем уровне две наиболее распространенные категории объектов, которые можно использовать для VisualBrush объекта, или UIElement ContainerVisual. UIElement охватывает в основном любой элемент пользовательского интерфейса, который в противном случае может участвовать в пользовательском интерфейсе для приложения WPF. ContainerVisual содержит объект DrawingGroup , включающий один или несколько производных Drawingобъектов.

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

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

Примечание

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

Использование элемента свойства XAML

<object>  
  <object.Visual>  
    singleVisualRoot  
  </object.Visual>  
</object>  

Использование атрибута XAML

<Объекта Visual ="{bindingExpression}"/>

-или-

<Объекта Visual ="{resourceExpression}"/>

Значения XAML

singleVisualRoot
Один элемент объекта, определяющий новый визуальный элемент для кисти. Это должен быть объект, производный от Visual. См. заметки.

bindingExpression
Выражение, результатом которого является существующий Visual экземпляр.

resourceExpression
Объект или StaticResource DynamicResource результат вычисления существующего Visual экземпляра. См. ресурсы XAML.

Сведения о свойстве зависимостей

Поле идентификатора	VisualProperty
Для свойств метаданных задано значение true	Нет