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 et utilisez-le pour définir la Visual propriété du VisualBrush.

• Utilisez un élément 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 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 objet 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 ou plusieurs Drawingobjets dérivés.

Lorsque vous définissez un nouveau Visual pour un VisualBrush et qu’il s’agit Visual 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 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ées 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 sur 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 propageront 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.

Note

Impossible VisualBrush d’effectuer une lecture seule (figée) lorsque sa Visual propriété 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 Élément objet unique 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 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

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