Informations
Le sujet que vous avez demandé est indiqué ci-dessous. Toutefois, ce sujet ne figure pas dans la bibliothèque.

FrameworkElement.Loaded, événement

Mise à jour : novembre 2007

Se produit lorsque l'élément est exposé, rendu, et prêt pour l'interaction.

Espace de noms :  System.Windows
Assembly :  PresentationFramework (dans PresentationFramework.dll)
XMLNS pour XAML : http://schemas.microsoft.com/winfx/xaml/presentation

public event RoutedEventHandler Loaded
/** @event */
public void add_Loaded (RoutedEventHandler value)
/** @event */
public void remove_Loaded (RoutedEventHandler value)

JScript ne prend pas en charge les événements.
<object Loaded="RoutedEventHandler" .../>

Champ d'identificateur

LoadedEvent

Stratégie de routage

Direct

Délégué

RoutedEventHandler

Loaded est habituellement le dernier événement déclenché dans une séquence d'initialisation d'éléments. Il est alors toujours déclenché après Initialized. Que vous choisissiez de gérer Loaded ou Initialized dépend de vos besoins. Si vous n'avez pas besoin de lire les propriétés d'un élément, de tenter de réinitialiser des propriétés et qu'il ne vous est pas nécessaire d'obtenir des informations relatives à la disposition, Initialized peut s'avérer l'événement le plus approprié sur lequel opérer. Si toutes les propriétés de l'élément doivent être disponibles et que vous définissez des propriétés qui pourraient réinitialiser la disposition, c'est alors Loaded qui peut constituer l'événement le plus adapté. Restez vigilant sur le risque de réentrance si votre gestionnaire réinitialise des propriétés interprétées par le système de disposition dont le but est d'indiquer qu'une nouvelle passe de disposition est requise. (Vous pouvez être amené à vérifier les valeurs de FrameworkPropertyMetadata sur la propriété si vous n'êtes pas certain des propriétés pouvant nécessiter une nouvelle passe de disposition en cas de modification.)

Pour plus d'informations sur la séquence d'événements d'objet pour FrameworkElement, mais aussi pour retrouver plusieurs classes relatives aux applications et aux éléments, consultez Événements de la durée de vie d'un objet.

Les événements routés directs ne suivent pas d'itinéraire. Ils sont contrôlés uniquement au sein du même élément sur lequel ils sont déclenchés. Les événements routés directs acceptent un autre comportement : ils prennent en charge une collection de gestionnaires accessible et peuvent être utilisés comme objet EventTrigger dans un style.

Loaded et Unloaded peuvent tous deux être déclenchés sur des contrôles suite à des modifications du thème système effectuées par l'utilisateur. Une modification du thème entraîne une invalidation du modèle de contrôle et de l'arborescence d'éléments visuels qui y est contenue, ce qui provoque ensuite le déchargement puis le rechargement de l'intégralité du contrôle. L'événement Loaded n'est donc pas censé se produire uniquement lorsqu'une page est chargée la première fois par le biais de l'accès à la page.

Cet exemple indique comment gérer l'événement FrameworkElement.Loaded et fournit un scénario approprié pour gérer cet événement. Le gestionnaire crée un Button lors du chargement de la page.

L'exemple suivant utilise le langage XAML (Extensible Application Markup Language) avec un fichier code-behind.

<StackPanel
  xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
  xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
  x:Class="SDKSample.FELoaded"
  Loaded="OnLoad"
  Name="root"
>
</StackPanel>


void OnLoad(object sender, RoutedEventArgs e)
{
    Button b1 = new Button();
    b1.Content = "New Button";
    root.Children.Add(b1);
    b1.Height = 25;
    b1.Width = 200;
    b1.HorizontalAlignment = HorizontalAlignment.Left;
}


Pour l'exemple complet, consultez Événement chargé, exemple.

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

Ajouts de la communauté

Afficher:
© 2014 Microsoft