VisualBrush.Visual Eigenschaft

Definition

Namespace:

System.Windows.Media

Assembly:

PresentationCore.dll

Ruft den Inhalt des Pinsels ab oder legt den Inhalt fest.

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

Visual

Der Inhalt des Pinsels. Der Standardwert lautet null.

Hinweise

Es gibt zwei Möglichkeiten zum Angeben des Visual Inhalts eines VisualBrush.

• Erstellen Sie eine neueVisual, und verwenden Sie es, um die Visual Eigenschaft der .VisualBrush

• Verwenden Sie ein vorhandenes Visual, das ein dupliziertes Bild des Ziels Visualerstellt. Anschließend können VisualBrush Sie interessante Effekte wie Spiegelung und Vergrößerung 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 Element für ein und VisualBrush das Visual ein UIElement (z. B. ein Panel oder Steuerelement) definieren, wird das Layoutsystem auf den UIElement untergeordneten Elementen ausgeführt, wenn die AutoLayoutContent Eigenschaft auf true". 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 Stamms UIElementangeben, da das einzige übergeordnete Element das VisualBrush und daher nicht automatisch die Größe für den zu bemalten Bereich ist. 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.

Anmerkung

Eine VisualBrush kann nicht schreibgeschützt (fixiert) werden, wenn die Visual Eigenschaft auf einen anderen Wert als nullfestgelegt ist.

XAML-Eigenschaftselementverwendung

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

XAML-Attributverwendung

< 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

Element	Wert
Bezeichnerfeld	VisualProperty
Auf Metadateneigenschaften festgelegt true	Nichts