VisualBrush.Visual Eigenschap

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

Waarde van eigenschap

De inhoud van de borstel. De standaardwaarde is null.

Opmerkingen

Er zijn twee manieren om de Visual inhoud van een VisualBrushop te geven.

• Maak een nieuwe Visual en gebruik deze om de eigenschap Visual van de VisualBrushin te stellen.

• Gebruik een bestaande Visual, waarmee een dubbele afbeelding van de doel-Visualwordt gemaakt. Vervolgens kunt u de VisualBrush gebruiken om interessante effecten te creëren, zoals weerspiegeling en vergroting.

Visual is vrij hoog in de algehele WPF klassehiërarchie, dus een zeer groot aantal objecten kan mogelijk fungeren als de visual die u gebruikt voor een VisualBrush; de hele lijst kan hier niet worden weergegeven. Zie Visual; raadpleeg de sectie Overnamehiërarchie, waarin de direct afgeleide klassen worden weergegeven. U kunt vervolgens op de direct afgeleide klassen klikken en de hiërarchieën doorlopen om een beeld te krijgen van het volledige scala aan mogelijkheden. Op het hoogste niveau zijn de twee meest voorkomende categorieën objecten die u kunt gebruiken voor een VisualBrush of UIElementContainerVisual. UIElement omvat in feite elk UI-element dat anders kan deelnemen aan de gebruikersinterface voor een WPF toepassing. ContainerVisual bevat een DrawingGroup of meer Drawingafgeleide objecten.

Wanneer u een nieuwe Visual definieert voor een VisualBrush en dat Visual een UIElement is (zoals een paneel of besturingselement), wordt het indelingssysteem uitgevoerd op de UIElement en de onderliggende elementen wanneer de eigenschap AutoLayoutContent is ingesteld op true. De hoofdmap UIElement is echter in wezen geïsoleerd van de rest van het systeem; stijlen, storyboards en externe indeling die door het bovenliggende element worden bepaald waar het penseel wordt toegepast, kan deze grens niet doorlaten. Daarom moet u expliciet de grootte van de root UIElementopgeven, aangezien het enige bovenliggende element de VisualBrush is en deze zichzelf daarom niet automatisch kan schalen naar het te schilderen gebied. Zie de Indelingvoor meer informatie over indeling in Windows Presentation Foundation (WPF).

Updates van de visuele boomstructuur van een VisualBrush worden niet doorgegeven als een BitmapEffect zich in de bovenliggende keten van de borstel bevindt. U kunt deze beperking omzeilen door een update van de scène af te dwingen op het object boven het effect. U kunt een animatie aanroepen InvalidateVisual of opnemen om een scène-update af te dwingen.

Gebruik van XAML-eigenschapselement

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

XAML-kenmerkgebruik

< ObjectVisual="{bindingExpression}"/>

– of –

< ObjectVisual="{resourceExpression}"/>

XAML-waarden

singleVisualRoot Eén objectelement dat een nieuw visueel element voor het penseel definieert. Dit moet een object zijn dat is afgeleid van Visual. Zie opmerkingen.

bindingExpression Een expressie die resulteert in een bestaand Visual exemplaar.

resourceExpression Een StaticResource of DynamicResource die evalueert naar een bestaand Visual exemplaar. Zie XAML-resources.

Informatie over afhankelijkheidseigenschappen