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.

• Créez un nouveau Visual fichier et utilisez-le pour définir la Visual propriété du VisualBrush.

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

Visual est assez élevé dans la hiérarchie de classes WPF globale, de sorte qu’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 une idée de la gamme complète de possibilités. Au niveau supérieur, les deux catégories d’objets les plus courantes que vous pouvez utiliser pour un VisualBrush objet sont UIElement ou ContainerVisual. UIElement englobe fondamentalement n’importe quel élément d’interface utilisateur qui peut autrement participer à l’interface utilisateur pour une application WPF. ContainerVisual contient un DrawingGroup ou plusieurs Drawingobjets dérivés.

Lorsque vous définissez un nouveau Visual pour un VisualBrush et qu’il Visual s’agit d’un UIElement (par exemple, un panneau ou un contrôle), le système de disposition s’exécute sur les UIElement éléments enfants et les éléments enfants lorsque la AutoLayoutContent propriété est définie truesur . 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 peut pas perméer 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 la disposition.

Les mises à jour de l’arborescence visuelle d’un VisualBrush ne se propagent pas si une BitmapEffect figure 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

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

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

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

Utilisation d'attributs XAML

<Objet Visual ="{bindingExpression}"/>

• ou -

<Objet Visual ="{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.

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

resourceExpression
DynamicResource Ou StaticResource qui prend la valeur d’une instance existanteVisual. Consultez les 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