VisualBrush.Visual Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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é
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 true
sur . 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 |