FrameworkPropertyMetadata.SubPropertiesDoNotAffectRender 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 une valeur qui indique si les sous-propriétés de la propriété de dépendance n’affectent pas le rendu de l’objet conteneur.
public:
property bool SubPropertiesDoNotAffectRender { bool get(); void set(bool value); };public bool SubPropertiesDoNotAffectRender { get; set; }member this.SubPropertiesDoNotAffectRender : bool with get, setPublic Property SubPropertiesDoNotAffectRender As BooleanValeur de propriété
true si les valeurs de sous-propriété n’affectent pas le rendu si elles sont modifiées ; sinon, false. La valeur par défaut est false.
Exceptions
Les métadonnées ont déjà été appliquées à une opération de propriété de dépendance : elles sont donc sealed et les propriétés des métadonnées ne peuvent pas être définies.
Remarques
Cette option de métadonnées est pertinente pour les propriétés de dépendance qui sont des types référence, où ce type a des valeurs de propriété propres. En règle générale, la logique système de disposition consiste à supposer que toute propriété de dépendance avec des sous-propriétés affecte potentiellement la disposition, car la vérification de toutes les sous-propriétés pour les modifications prend plus de temps que l’exécution d’une autre passe de rendu. La définition de true cette option est utile pour optimiser les performances de l’implémentation du système de disposition au niveau de l’infrastructure WPF.
Les propriétés sur les classes dérivées de PropertyMetadata sont généralement définies dans le modèle objet en lecture-écriture. C’est pourquoi ils peuvent être ajustés après l’initialisation de l’instance. Toutefois, une fois que les métadonnées sont consommées dans le cadre d’un appel à Register, AddOwnerou OverrideMetadata, le système de propriétés scellera cette instance de métadonnées et les propriétés qui transmettent les spécificités des métadonnées sont désormais considérées comme immuables. Toute tentative de définition de cette propriété après IsSealed avoir été true effectuée sur cette instance de métadonnées génère une exception.
Utilisation du texte XAML
Les membres de cette classe ne sont généralement pas utilisés en XAML.