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, den Visual Inhalt einer VisualBrushanzugeben.There are two ways to specify the Visual content of a VisualBrush.

  • Erstellen Sie einen Visual neuen, und verwenden Sie ihn Visual zum Festlegen der VisualBrush-Eigenschaft von.Create a new Visual and use it to set the Visual property of the VisualBrush.

  • Verwenden Sie ein Visualvorhandenes, das ein doppeltes Bild des Ziels Visualerstellt.Use an existing Visual, which creates a duplicate image of the target Visual. Anschließend können Sie mit dem VisualBrush interessante Effekte erstellen, z. b. Reflektion und Vergrößerung.You can then use the VisualBrush to create interesting effects, such as reflection and magnification.

Visualist in der WPF-Klassenhierarchie sehr hoch, sodass eine sehr große Anzahl von Objekten möglicherweise als visuelles Element dient, das Sie für VisualBrusheine verwenden. 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. Weitere VisualInformationen finden Sie im Abschnitt "Vererbungs Hierarchie", in dem die sofort abgeleiteten Klassen angezeigt werden.See Visual; refer to the "Inheritance Hierarchy" section, which will show the immediately derived classes. Sie können dann auf die sofort abgeleiteten Klassen klicken und die Hierarchien durchlaufen, um einen Eindruck von allen 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 werden VisualBrush UIElement die beiden häufigsten Kategorien von Objekten, die Sie für eine verwenden können, ContainerVisualoder verwendet.At a top level, the two most common categories of objects you might use for a VisualBrush are UIElement or ContainerVisual. UIElementumfasst im Grunde alle Benutzeroberflächen Elemente, die andernfalls an der Benutzeroberfläche für eine WPF-Anwendung teilnehmen können.UIElement encompasses basically any UI element that can otherwise participate in the UI for a WPF application. ContainerVisualenthält ein DrawingGroup -Objekt, das ein Drawingoder mehrere von abgeleitete-Objekte enthält.ContainerVisual contains a DrawingGroup that includes one or more Drawing-derived objects.

Wenn Sie einen neuen Visual für einen VisualBrush Visual definieren, der ein UIElement ist (z. b. ein Panel oder Steuerelement), wird das Layoutsystem auf dem UIElement und seinen AutoLayoutContent untergeordneten Elementen ausgeführt true, wenn die-Eigenschaft auf festgelegt ist.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. Der UIElement Stamm ist aber im Wesentlichen vom restlichen System isoliert; Stile, Storyboards und externes Layout, die vom übergeordneten Element, in dem der Pinsel angewendet wird, vorgeschrieben sind, können diese Grenze 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 die Größe des UIElementStamms explizit angeben, da das einzige übergeordnete Element das VisualBrush -Element ist und sich daher nicht automatisch für den Bereich eignet, der gezeichnet wird.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.

Aktualisierungen an der visuellen Struktur eines VisualBrush werden nicht weitergegeben, wenn ein BitmapEffect in der übergeordneten Kette des Pinsels 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 für das Objekt über der Auswirkung erzwingen.You can workaround this limitation by forcing an update of the scene on the object above the effect. Sie können eine InvalidateVisual Animation zum Erzwingen eines Szenen Updates abrufen oder einschließen.You can call InvalidateVisual or include an animation to force a scene update.

Hinweis

Ein VisualBrush kann nicht als schreibgeschützt festgelegt werden (eingefroren) Visual , wenn seine-Eigenschaft auf einen anderen Wert als festgelegt ist.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 = "{BindingExpression}"/> Visual<object Visual="{bindingExpression}"/>

- oder --or-

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

XAML-WerteXAML Values

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

bindingExpression
Ein, der zu einer vorhandenen Visual -Instanz ausgewertet wird.A that evaluates to an existing Visual instance.

resourceExpression
Ein StaticResource Visual oder DynamicResource , das zu einer vorhandenen-Instanz ausgewertet wird.A StaticResource or DynamicResource that evaluates to an existing Visual instance. Siehe XAML-RessourcenSee XAML Resources

Informationen zur AbhängigkeitseigenschaftDependency Property Information

BezeichnerfeldIdentifier field VisualProperty
Metadateneigenschaften auf true festgelegtMetadata properties set to true KeineNone

Gilt für: