VisualBrush.Visual Propriété

Définition

Espace de noms:

System.Windows.Media

Assembly:

PresentationCore.dll

Obtient ou définit le contenu du pinceau.

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

Valeur de propriété

Visual

Contenu du pinceau. La valeur par défaut est null.

Remarques

Il existe deux façons de spécifier le Visual contenu d’un VisualBrush.

• Create un nouveau Visual et l’utiliser pour définir la Visual propriété de .VisualBrush

• Utilisez un existant Visual, qui crée une image en double de la cible Visual. Vous pouvez ensuite utiliser pour créer des effets intéressants, tels que la réflexion et l’agrandissement VisualBrush .

Visual étant assez élevé dans la hiérarchie de classes WPF globale, un très grand nombre d’objets pourrait éventuellement servir de visuel que vous utilisez pour un VisualBrush; la liste entière ne peut pas être affichée ici. Consultez Visual; reportez-vous à la section « Hiérarchie d’héritage », qui affiche les classes dérivées immédiatement. Vous pouvez ensuite cliquer sur les classes dérivées immédiatement et parcourir les hiérarchies pour avoir une idée de l’ensemble des possibilités. À un niveau supérieur, les deux catégories d’objets les plus courantes que vous pouvez utiliser pour un VisualBrush sont UIElement ou ContainerVisual. UIElement englobe essentiellement n’importe quel élément d’interface utilisateur qui peut autrement participer à l’interface utilisateur d’une application WPF. ContainerVisual contient un DrawingGroup qui inclut un ou plusieurs Drawingobjets dérivés.

Lorsque vous définissez un nouveau Visual pour un VisualBrush et qui est un UIElement (tel qu’un Visual panneau ou un contrôle), le système de disposition s’exécute sur et UIElement ses éléments enfants lorsque la AutoLayoutContent propriété a la truevaleur . Toutefois, la racine UIElement est essentiellement isolée du reste du système ; les styles, les storyboards et la disposition externe dictés par le parent où le pinceau est appliqué ne peuvent pas s’appliquer à cette limite. Par conséquent, vous devez spécifier explicitement la taille de la racine UIElement, car son seul parent est le VisualBrush et, par conséquent, il ne peut pas se dimensionner automatiquement à la zone en cours de peinture. Pour plus d’informations sur la disposition dans Windows Presentation Foundation (WPF), consultez Disposition.

Mises à jour à l’arborescence visuelle d’un VisualBrush ne se propage pas si un BitmapEffect se trouve dans la chaîne parente du pinceau. Vous pouvez contourner cette limitation en forçant une mise à jour de la scène sur l’objet au-dessus de l’effet. Vous pouvez appeler InvalidateVisual ou inclure une animation pour forcer une mise à jour de scène.

Notes

Un VisualBrush ne peut pas être en lecture seule (figé) lorsque sa Visual propriété a une valeur autre que null.

Utilisation des éléments de propriété XAML

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

Utilisation d'attributs XAML

<ObjetVisual="{bindingExpression}"/>

-ou-

<ObjetVisual="{resourceExpression}"/>

Valeurs XAML

singleVisualRoot Élément objet unique qui définit un nouvel élément visuel pour le pinceau. Il doit s’agir d’un objet qui dérive de Visual. Consultez la section Notes.

bindingExpressionExpression qui prend la valeur d’une instance existante Visual .

resourceExpressionStaticResource ou DynamicResource qui prend la valeur d’une instance existante Visual . Consultez Ressources XAML.

Informations sur les propriétés de dépendance

Champ Identificateur	VisualProperty
Propriétés de métadonnées définies sur true	Aucun