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 или UIElementContainerVisual. UIElement охватывает в основном любой элемент пользовательского интерфейса, который может в противном случае участвовать в пользовательском интерфейсе для приложения WPF. ContainerVisual содержит объект DrawingGroup , содержащий один или несколько производных Drawingобъектов.

При определении нового Visual для объекта VisualBrush и VisualUIElement т. д. (например, панели или элемента управления) система макета выполняется на UIElement дочерних элементах, когда AutoLayoutContent свойству присвоено значение true. Однако корневой каталог UIElement по сути изолирован от остальной части системы; стили, раскадровки и внешний макет, диктуемый родительским элементом, где применяется кисть, не может пронизывать эту границу. Таким образом, необходимо явно указать размер корневого элемента UIElement, так как его единственный родительский элемент является VisualBrush и поэтому не может автоматически изменять размер области, нарисованной. Дополнительные сведения о макете в Windows Presentation Foundation (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 DynamicResource Значение или StaticResource значение для существующего Visual экземпляра. См. статью "Ресурсы XAML".

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

Элемент	Ценность
Поле идентификатора	VisualProperty
Свойства метаданных, равные свойству true	Никакой