FrameworkElement.LayoutUpdated Événement

Définition

Espace de noms:

Microsoft.UI.Xaml

Se produit lorsque la disposition de l’arborescence visuelle change, en raison de la modification de la valeur des propriétés pertinentes pour la disposition ou d’une autre action qui actualise la disposition.

// Register
event_token LayoutUpdated(EventHandler<IInspectable> const& handler) const;

// Revoke with event_token
void LayoutUpdated(event_token const* cookie) const;

// Revoke with event_revoker
FrameworkElement::LayoutUpdated_revoker LayoutUpdated(auto_revoke_t, EventHandler<IInspectable> const& handler) const;

public event System.EventHandler<object> LayoutUpdated;

function onLayoutUpdated(eventArgs) { /* Your code */ }
frameworkElement.addEventListener("layoutupdated", onLayoutUpdated);
frameworkElement.removeEventListener("layoutupdated", onLayoutUpdated);
- or -
frameworkElement.onlayoutupdated = onLayoutUpdated;

Public Custom Event LayoutUpdated As EventHandler(Of Object) 

<frameworkElement LayoutUpdated="eventhandler"/>
 

Type d'événement

EventHandler<Object>

EventHandler<Object>

EventHandler<IInspectable>

Remarques

LayoutUpdated est le dernier événement de durée de vie d’objet à se produire dans la séquence de chargement XAML avant qu’un contrôle soit prêt pour l’interaction. Toutefois, LayoutUpdated peut également se produire au moment de l’exécution pendant la durée de vie de l’objet, pour diverses raisons : un changement de propriété, un redimensionnement de fenêtre ou une demande de disposition du runtime (UpdateLayout ou un modèle de contrôle modifié). L’événement LayoutUpdated est déclenché après que tous les événements SizeChanged d’une séquence de disposition se produisent.

LayoutUpdated peut se produire lorsque l’objet sur lequel le gestionnaire est attaché ne change pas nécessairement quoi que ce soit dans l’arborescence visuelle située sous celui-ci. Par instance, imaginez un conteneur de disposition où deux éléments enfants partagent de l’espace. Si le premier objet modifie une propriété qui force une nouvelle disposition, les deux objets déclenchent LayoutUpdated, car le deuxième objet peut être repositionné même si sa propre disposition secondaire ne change pas.

Lorsque vous gérez LayoutUpdated, ne vous fiez pas à la valeur de l’expéditeur . Pour LayoutUpdated, l’expéditeur est toujours null, quel que soit l’emplacement où le gestionnaire est attaché. Il s’agit d’empêcher les gestionnaires d’attribuer une signification quelconque à l’expéditeur, par exemple en supposant que c’est cet élément spécifique qui a déclenché l’événement hors de l’arborescence visuelle. LayoutUpdated implique qu’un élément de l’arborescence visuelle globale a changé et que chaque objet spécifique n’importe où dans l’arborescence a la possibilité de gérer cette occurrence. Si vous êtes familiarisé avec la conception d’API de rendu de niveau inférieur, vous pouvez assimiler LayoutUpdated le fait d’être déclenché comme similaire à un indicateur « redessiner nécessaire » défini dans le cadre d’une logique de rendu en mode conservé piloté par objet.

Étant donné LayoutUpdated que se déclenche dans de nombreuses circonstances et n’est pas toujours spécifique à un objet qui change réellement, déterminez si la gestion de l’événement SizeChanged à la place est plus appropriée pour votre scénario.

Voir aussi

• SizeChanged