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

Visual имеет довольно высокий уровень в общей иерархии классов WPF, поэтому очень большое количество объектов может служить визуальным элементом, используемым 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`	Нет

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

Share via