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 modifications apportées aux 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, afin que les métadonnées soient scellées et que les propriétés des métadonnées ne puissent 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 de 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 est plus longue que l’exécution d’une autre passe de rendu. La définition de cette option sur true 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 elles peuvent être ajustées après l’initialisation de l’instance. Toutefois, une fois les métadonnées 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. Une 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.