FrameworkPropertyMetadata.AffectsParentArrange 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 une propriété de dépendance peut affecter la passe de réorganisation de la disposition de son élément parent durant les opérations du moteur de disposition.
public:
property bool AffectsParentArrange { bool get(); void set(bool value); };public bool AffectsParentArrange { get; set; }member this.AffectsParentArrange : bool with get, setPublic Property AffectsParentArrange As BooleanValeur de propriété
true si la propriété de dépendance sur laquelle ces métadonnées existent peut affecter la passe de réorganisation spécifiquement sur son élément parent ; 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
FrameworkElement et FrameworkContentElement incluez une implémentation de ce qui surveille les modifications de valeur effectives apportées à toutes les propriétés de OnPropertyChanged dépendance qui existent sur un élément. Dans le cadre de cette logique, les propriétés de dépendance qui modifient la valeur effective et dont les métadonnées sont AffectsParentArrange définies true lancent une demande différée pour invalider les visuels de l’élément parent.
En règle générale, vous n’avez pas besoin de signaler les modifications d’une FrameworkElement propriété à un élément parent à l’aide AffectsParentArrange du fait que l’élément lui-même aurait déjà sa propre propriété AffectsArrange true. Cela suffit généralement, car les modifications apportées à l’élément enfant lancent généralement une organisation parente le cas échéant. AffectsParentArrange est parfois utilisé pour une FrameworkContentElement classe dérivée. Dans ce cas, l’élément enfant définit une propriété, mais une FrameworkContentElement classe dérivée ne contrôle pas son propre rendu. Le rendu est géré par un FrameworkElement élément parent qui sert d’hôte de contenu. Par exemple, une modification de la valeur de la FixedPage.Left propriété jointe par un élément enfant invalide l’organisation du parent, car la position de l’enfant dans le parent doit être modifiée. Par conséquent, la FixedPage.Left propriété jointe a des métadonnées où AffectsParentArrange il s’agit true. Un autre exemple est Padding: lorsque cette propriété change, le parent peut modifier le positionnement de l’enfant, en fonction de l’espace disponible.
Étant donné que cette implémentation au niveau de l’infrastructure WPF est déjà en place, vous n’avez généralement pas besoin de rechercher des propriétés AffectsParentArrange de dépendance, sauf si vous remplacez ou modifiez considérablement le comportement de disposition au niveau de l’infrastructure WPF.
Les implémentations personnalisées OnPropertyChanged peuvent choisir d’avoir un comportement similaire pour les modifications de propriété de dépendance où AffectsParentArrange il s’agit true.
Les propriétés sur toutes 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 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. 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.