VisualBrush.Visual VisualBrush.Visual VisualBrush.Visual VisualBrush.Visual Property

Definition

Ruft den Inhalt des Pinsels ab oder legt ihn fest.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

Eigenschaftswert

Der Inhalt des Pinsels.The brush's content. Die Standardeinstellung ist null.The default is null.

Hinweise

Es gibt zwei Möglichkeiten zum Angeben der Visual Inhalt von einem VisualBrush.There are two ways to specify the Visual content of a VisualBrush.

  • Erstellen Sie ein neues Visual und verwenden sie zum Festlegen der Visual Eigenschaft der VisualBrush.Create a new Visual and use it to set the Visual property of the VisualBrush.

  • Verwenden Sie ein vorhandenes Visual, wodurch ein Bildduplikat vom Ziel erstellt Visual.Use an existing Visual, which creates a duplicate image of the target Visual. Anschließend können Sie die VisualBrush interessante Effekte, z.B. Reflektion und Vergrößerung zu erstellen.You can then use the VisualBrush to create interesting effects, such as reflection and magnification.

Visual sehr weit oben in der gesamten WPF-Klassenhierarchie ist, sodass eine sehr große Anzahl von Objekten möglicherweise als das visuelle Element werden, mit denen Sie verwendet kann für eine VisualBrush; die gesamte Liste kann hier nicht angezeigt werden.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. Finden Sie unter Visual; finden Sie im Abschnitt "Vererbungshierarchie", der unmittelbar abgeleiteten Klassen aufgeführt werden.See Visual; refer to the "Inheritance Hierarchy" section, which will show the immediately derived classes. Anschließend können Sie klicken Sie auf der unmittelbar abgeleiteten Klassen und durchlaufen die Hierarchien, um einen Überblick über das gesamte Spektrum an Möglichkeiten zu erhalten.You can then click on the immediately derived classes and traverse the hierarchies to get a sense of the full range of possibilities. Auf der obersten Ebene, die zwei allgemeinsten Kategorien von Objekten können für eine VisualBrush sind UIElement oder ContainerVisual.At a top level, the two most common categories of objects you might use for a VisualBrush are UIElement or ContainerVisual. UIElement umfasst im Wesentlichen beliebiges Benutzeroberflächenelement an, die andernfalls in der Benutzeroberfläche für eine WPF-Anwendung teilnehmen kann.UIElement encompasses basically any UI element that can otherwise participate in the UI for a WPF application. ContainerVisual enthält eine DrawingGroup , enthält eine oder mehrere Drawing--abgeleitete Objekte.ContainerVisual contains a DrawingGroup that includes one or more Drawing-derived objects.

Beim Definieren einer neuen Visual für eine VisualBrush und Visual ist eine UIElement (z. B. ein Bereich oder Steuerelement), der das Layoutsystem führt auf der UIElement und seine untergeordneten Elemente bei der AutoLayoutContent -Eigenschaftensatz auf 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. Jedoch den Stamm UIElement ist im Wesentlichen isoliert vom Rest des Systems festgelegt wird; Stile, Storyboards und externes Layout hängt vom übergeordneten Element, der Pinsel angewendet, können diese Abgrenzung nicht durchdringen.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. Daher sollten Sie explizit die Größe des Stamms angeben UIElement, da nur das übergeordnete Element ist die VisualBrush und sich daher nicht automatisch auf den gezeichneten Bereich anpassen kann.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. Weitere Informationen zum Layout in Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF) finden Sie unter Layout.For more information about layout in Windows Presentation Foundation (WPF)Windows Presentation Foundation (WPF), see the Layout.

Updates für die visuelle Struktur einer VisualBrush werden nicht übertragen werden, wenn eine BitmapEffect des Pinsels übergeordneten Kette ist.Updates to the visual tree of a VisualBrush will not propagate if a BitmapEffect is in the brush's parent chain. Sie können diese Einschränkung umgehen, indem Sie ein Update der Szene auf das Objekt über die Auswirkungen zu erzwingen.You can workaround this limitation by forcing an update of the scene on the object above the effect. Rufen Sie InvalidateVisual oder schließen Sie eine Animation, um eine Aktualisierung der Szene zu erzwingen.You can call InvalidateVisual or include an animation to force a scene update.

Hinweis

Ein VisualBrush kann nicht als schreibgeschützt (fixiert) werden, wenn die Visual -Eigenschaftensatz auf einen beliebigen Wert außer null.A VisualBrush cannot be made read-only (frozen) when its Visual property is set to any value other than null.

Verwendung von XAML-EigenschaftenelementenXAML Property Element Usage

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

Verwendung von XAML-AttributenXAML Attribute Usage

<Objekt Visual= "{BindingExpression}" / ><object Visual="{bindingExpression}"/>

- oder - -or-

<Objekt Visual= "{ResourceExpression}" / ><object Visual="{resourceExpression}"/>

XAML-WerteXAML Values

singleVisualRoot
Ein einzelnes Objekt-Element, ein neues visuelles Element für den Pinsel definiert.A single object element that defines a new visual element for the brush. Dies muss ein Objekt, das abgeleitet sein Visual.This must be an object that derives from Visual. Siehe Hinweise.See Remarks.

bindingExpression
Ein, der eine vorhandene ergibt Visual Instanz.A that evaluates to an existing Visual instance.

resourceExpression
Ein StaticResource oder DynamicResource , ausgewertet wird zu einem vorhandenen Visual Instanz.A StaticResource or DynamicResource that evaluates to an existing Visual instance. Finden Sie unter XAML-RessourcenSee XAML Resources

Informationen zur AbhängigkeitseigenschaftDependency Property Information

Feld "ID"Identifier field VisualProperty
Legen Sie auf der Metadaten-Eigenschaften trueMetadata properties set to true NoneNone

Gilt für: