VisualBrush.Visual Eigenschaft

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. Der Standardwert lautet null.

Hinweise

Es gibt zwei Möglichkeiten, den Visual-Inhalt einer VisualBrush anzugeben.

• Erstellen Sie eine neue Visual, und verwenden Sie sie, um die Visual-Eigenschaft des VisualBrush festzulegen.

• Verwenden Sie ein vorhandenes Visual, wodurch ein Duplikat des Visual-Ziels erstellt wird. Anschließend können Sie die VisualBrush verwenden, um interessante Effekte wie Spiegelung und Vergrößerung zu erzeugen.

Visual ist ziemlich hoch in der Gesamthierarchie der WPF-Klasse, sodass eine sehr große Anzahl von Objekten möglicherweise als visuelles Element dienen könnte, das Sie für eine VisualBrush; die gesamte Liste kann hier nicht angezeigt werden. Siehe Visual; siehe Abschnitt "Vererbungshierarchie", in dem die unmittelbar abgeleiteten Klassen angezeigt werden. Sie können dann auf die unmittelbar abgeleiteten Klassen klicken und die Hierarchien durchlaufen, um ein Gefühl für die gesamte Palette von Möglichkeiten zu erhalten. Auf oberster Ebene sind die beiden am häufigsten verwendeten Objektkategorien für ein VisualBrushUIElement Objekt oder ContainerVisual. UIElement umfasst grundsätzlich jedes UI-Element, das andernfalls an der Benutzeroberfläche für eine WPF-Anwendung teilnehmen kann. ContainerVisual enthält ein DrawingGroup Objekt, das mindestens ein Drawingabgeleitetes Objekt enthält.

Wenn Sie ein neues Visual für ein VisualBrush und Visual als UIElement definieren (z. B. ein Bedienfeld oder ein Steuerelement), wird das Layoutsystem auf dem UIElement und seinen untergeordneten Elementen ausgeführt, wenn die AutoLayoutContent-Eigenschaft auf true gesetzt ist. Der Stamm UIElement ist jedoch im Wesentlichen vom restlichen System isoliert. Stile, Storyboards und externes Layout, das vom übergeordneten Element bestimmt wird, auf das der Pinsel angewendet wird, kann diese Grenze nicht durchdringen. Daher sollten Sie explizit die Größe des Stamm-UIElement angeben, zumal VisualBrush sein einziges übergeordnetes Objekt ist und es sich deshalb nicht automatisch an den gezeichneten Bereich anpassen kann. Weitere Informationen zum Layout in Windows Presentation Foundation (WPF) finden Sie im Layout.

Aktualisierungen der visuellen Struktur eines VisualBrush Elements werden nicht weitergegeben, wenn sich ein BitmapEffect Element in der übergeordneten Kette des Pinsels befindet. Sie können diese Einschränkung umgehen, indem Sie eine Aktualisierung der Szene für das Objekt über dem Effekt erzwingen. Sie können eine Animation aufrufen InvalidateVisual oder einschließen, um eine Szenenaktualisierung zu erzwingen.

Verwendung von XAML-Eigenschaftenelementen

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

Verwendung von XAML-Attributen

< ObjektVisual="{bindingExpression}"/>

-oder-

< ObjektVisual="{resourceExpression}"/>

XAML-Werte

singleVisualRoot Ein einzelnes Objektelement, das ein neues visuelles Element für den Pinsel definiert. Dies muss ein Objekt sein, das von Visual. Siehe Anmerkungen.

bindingExpression Ein Ausdruck, der zu einer vorhandenen Visual Instanz ausgewertet wird.

resourceExpression A StaticResource oder DynamicResource das zu einer vorhandenen Visual Instanz ausgewertet wird. Siehe XAML-Ressourcen.

Informationen zur Abhängigkeitseigenschaft