Cette documentation est archivée et n’est pas conservée.

UIElement.UpdateLayout, méthode

Mise à jour : novembre 2007

Permet de s'assurer que tous les éléments enfants visuels de cet élément sont correctement mis à jour en vue de la disposition.

Espace de noms :  System.Windows
Assembly :  PresentationCore (dans PresentationCore.dll)

public void UpdateLayout()
public void UpdateLayout()
public function UpdateLayout()
Vous ne pouvez pas utiliser des méthodes en XAML.

Lorsque vous appelez cette méthode, les éléments munis de la propriété IsMeasureValid false ou IsArrangeValid false appellent les méthodes MeasureCore et ArrangeCore qui leur sont spécifiques, ce qui entraîne l'actualisation de la disposition et la validation de toutes les tailles calculées.

L'appel à cette méthode n'a aucun effet si la disposition est inchangée, ou si l'état d'agencement ou de mesure d'une disposition n'est pas valide. Toutefois, si la disposition n'est pas valide dans l'un des points précités, l'appel à UpdateLayout entraîne une redisposition complète. Par conséquent, vous devez éviter d'appeler UpdateLayout après chaque modification incrémentielle et mineure dans l'arborescence d'éléments. Le système de disposition effectue la disposition des éléments de façon différée, à l'aide d'un algorithme cherchant un compromis entre performances et actualité de la disposition, en mettant en œuvre une stratégie de pondération pour reporter les modifications aux racines jusqu'à ce que tous les éléments enfants soient valides. Vous ne devez appeler UpdateLayout que si vous avez absolument besoin de dimensions et de positions actualisées, et seulement si vous êtes certain que toutes les modifications apportées aux propriétés, que vous contrôlez et qui peuvent affecter la disposition, soient terminées.

Windows Vista

Le .NET Framework et le .NET Compact Framework ne prennent pas en charge toutes les versions de chaque plateforme. Pour obtenir la liste des versions prises en charge, consultez Configuration requise du .NET Framework.

.NET Framework

Pris en charge dans : 3.5, 3.0
Afficher: