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 contenu Visual d’un VisualBrush.

• Créez une Visual et utilisez-la pour définir la propriété Visual du VisualBrush.

• Utilisez un Visualexistant, qui crée une image dupliquée du Visualcible. Vous pouvez ensuite utiliser le VisualBrush pour créer des effets intéressants, tels que la réflexion et l’agrandissement.

Visual est assez élevé dans la hiérarchie de classes WPF globale, donc 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. Voir 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 un sens de la gamme complète de possibilités. Au niveau supérieur, les deux catégories les plus courantes d’objets 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 objets dérivés de Drawing.

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

Les mises à jour apportées à l’arborescence visuelle d’un VisualBrush ne se propagent 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.

Note

Une VisualBrush ne peut pas être effectuée en lecture seule (figée) lorsque sa propriété Visual est définie sur n’importe quelle valeur autre que null.

Utilisation de l’élément de propriété XAML

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

Utilisation des attributs XAML

< objetVisual="{bindingExpression}"/>

-ou-

< objetVisual="{resourceExpression}"/>

Valeurs XAML

singleVisualRoot un seul élément objet qui définit un nouvel élément visuel pour le pinceau. Il doit s’agir d’un objet dérivé de Visual. Voir les remarques.

bindingExpression Expression qui prend la valeur d’une instance de Visual existante.

resourceExpression un StaticResource ou DynamicResource qui prend la valeur d’une instance de Visual existante. Consultez de ressources XAML.

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

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