VisualBrush.Visual Свойство

Определение

Получает или задает содержимое кисти.Gets or sets the brush's content.

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

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

Содержимое кисти.The brush's content. Значение по умолчанию — null.The default is null.

Комментарии

Существует два способа указания Visual содержимого. VisualBrushThere are two ways to specify the Visual content of a VisualBrush.

  • Создайте новый Visual и используйте его для Visual задания свойства объекта VisualBrush.Create a new Visual and use it to set the Visual property of the VisualBrush.

  • Используйте существующий Visual, который создает дубликат изображения целевого объекта Visual.Use an existing Visual, which creates a duplicate image of the target Visual. Затем можно использовать VisualBrush для создания интересных эффектов, таких как отражение и увеличение.You can then use the VisualBrush to create interesting effects, such as reflection and magnification.

Visualочень высокий в общей иерархии классов WPF, поэтому очень большое количество объектов может служить визуальным элементом, который используется для a VisualBrush; здесь не может отображаться весь список.Visual is quite high in the overall WPF class hierarchy, so a very large number of objects could possibly serve as the visual that you use for a VisualBrush; the entire list cannot be shown here. См Visual. раздел: "Иерархия наследования", в которой будут показаны классы, наследуемые непосредственно.See Visual; refer to the "Inheritance Hierarchy" section, which will show the immediately derived classes. Затем можно щелкнуть непосредственно производные классы и пройти по иерархии, чтобы получить представление о полном диапазоне возможностей.You can then click on the immediately derived classes and traverse the hierarchies to get a sense of the full range of possibilities. На верхнем уровне две наиболее распространенные категории объектов, которые можно использовать для VisualBrush , — UIElement или ContainerVisual.At a top level, the two most common categories of objects you might use for a VisualBrush are UIElement or ContainerVisual. UIElementохватывает по сути любой элемент пользовательского интерфейса, который в противном случае может участвовать в пользовательском интерфейсе приложения WPF.UIElement encompasses basically any UI element that can otherwise participate in the UI for a WPF application. ContainerVisualсодержит, включающий один или несколько Drawingпроизводных объектов. DrawingGroupContainerVisual contains a DrawingGroup that includes one or more Drawing-derived objects.

Visual При определении нового VisualBrush для и, который Visual является UIElement (например, UIElement панелью или элементом управления), система AutoLayoutContent макета выполняется в и ее дочерних элементах, если свойство имеет значение true.When you define a new Visual for a VisualBrush and that Visual is a UIElement (such as a panel or control), the layout system runs on the UIElement and its child elements when the AutoLayoutContent property is set to true. Однако корень UIElement по сути является изолированным от остальной части системы; стили, раскадровки и внешний макет, определяемый родительским объектом, к которому применяется кисть, не может перейти эту границу.However, the root UIElement is essentially isolated from the rest of the system; styles, storyboards, and external layout dictated by the parent where the brush is applied cannot permeate this boundary. Поэтому следует явно указать размер корня UIElement, так как его единственный родительский элемент VisualBrush — и, поэтому он не может автоматически масштабироваться до закрашиваемой области.Therefore, you should explicitly specify the size of the root UIElement, because its only parent is the VisualBrush and therefore it cannot automatically size itself to the area being painted. Дополнительные сведения о макете в Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) см. в разделе Макет.For more information about layout in Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF), see the Layout.

Обновления визуального дерева объекта VisualBrush не будут распространяться, BitmapEffect если есть в родительской цепочке кисти.Updates to the visual tree of a VisualBrush will not propagate if a BitmapEffect is in the brush's parent chain. Чтобы устранить это ограничение, можно принудительно обновить сцену на объекте, расположенном выше этого эффекта.You can workaround this limitation by forcing an update of the scene on the object above the effect. Для принудительного InvalidateVisual обновления сцены можно вызвать или включить анимацию.You can call InvalidateVisual or include an animation to force a scene update.

Примечание

Невозможно VisualBrush сделать недоступным только для чтения (зафиксированным Visual ), если его свойство имеет любое значение, отличное отnull.A VisualBrush cannot be made read-only (frozen) when its Visual property is set to any value other than null.

Использование элемента свойства XAMLXAML Property Element Usage

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

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

<объект = "{bindingExpression}"/>** Visual<object Visual="{bindingExpression}"/>

- или --or-

<объект = "{ресаурцеекспрессион}"/>** Visual<object Visual="{resourceExpression}"/>

Значения XAMLXAML Values

singleVisualRoot
Один элемент объекта, определяющий новый визуальный элемент для кисти.A single object element that defines a new visual element for the brush. Это должен быть объект, производный от Visual.This must be an object that derives from Visual. См. заметки.See Remarks.

bindingExpression
Объект, который вычисляется как существующий Visual экземпляр.A that evaluates to an existing Visual instance.

resourceExpression
Объект StaticResource Visual или DynamicResource , результатом которого является существующий экземпляр.A StaticResource or DynamicResource that evaluates to an existing Visual instance. См. ресурсы XAMLSee XAML Resources

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

Поле идентификатораIdentifier field VisualProperty
Свойства метаданных, для которых задано значениеtrueMetadata properties set to true НетNone

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