FrameworkElement.Loaded イベント


要素がレイアウトされ、レンダリングされて、操作を受け入れる準備が整ったときに発生します。Occurs when the element is laid out, rendered, and ready for interaction.

 event System::Windows::RoutedEventHandler ^ Loaded;
public event System.Windows.RoutedEventHandler Loaded;
member this.Loaded : System.Windows.RoutedEventHandler 
Public Custom Event Loaded As RoutedEventHandler 


通常、Loaded は、要素の初期化シーケンスで最後に発生したイベントです。Loaded is usually the last event raised in an element initialization sequence. Initialized後に常に発生します。It will always be raised after Initialized. LoadedInitialized のどちらを処理するかは、要件によって異なります。Whether you choose to handle Loaded or Initialized depends on your requirements. 要素のプロパティを読み取り、プロパティをリセットする必要がなく、レイアウト情報を必要としない場合は、Initialized の動作に適したイベントである可能性があります。If you do not need to read element properties, intend to reset properties, and do not need any layout information, Initialized might be the better event to act upon. 要素のすべてのプロパティを使用できるようにする必要があり、レイアウトをリセットする可能性のあるプロパティを設定する場合は、Loaded 動作する方が適切なイベントである可能性があります。If you need all properties of the element to be available, and you will be setting properties that are likely to reset the layout, Loaded might be the better event to act upon. 新しいレイアウトパスが必要であることを示すために、ハンドラーがレイアウトシステムによって解釈されるプロパティをリセットする場合は、再入に注意してください。Be careful of reentrancy if your handler resets any properties that are interpreted by the layout system to mean that a new layout pass is required. (変更された場合、新しいレイアウトパスを必要とするプロパティがわからない場合は、プロパティの FrameworkPropertyMetadata 値を確認する必要があります)。(You might need to check the FrameworkPropertyMetadata values on the property if you are unsure of which properties can require a new layout pass if they are changed.)

FrameworkElementのオブジェクトイベントのシーケンス、および関連するいくつかのアプリケーションおよび要素クラスの詳細については、「オブジェクトの有効期間イベント」を参照してください。For more information about the sequence of object events for a FrameworkElement, and also for several related application and element classes, see Object Lifetime Events.

ダイレクトルーティングイベントはルートに従わないので、これらのイベントは、発生したものと同じ要素内でのみ処理されます。Direct routed events do not follow a route, they are only handled within the same element on which they are raised. 直接ルーティングイベントでは、他のルーティングイベントの動作がサポートされます。これらは、アクセス可能なハンドラーコレクションをサポートし、スタイルの EventTrigger として使用できます。Direct routed events do support other routed event behavior: they support an accessible handlers collection, and can be used as an EventTrigger in a style.

ユーザーが開始したシステムテーマの変更の結果として、LoadedUnloaded の両方がコントロールで発生する可能性があります。Loaded and Unloaded might both be raised on controls as a result of user-initiated system theme changes. テーマを変更すると、コントロールテンプレートとそれに含まれるビジュアルツリーが無効化されます。これにより、コントロール全体がアンロードされ、再読み込みされます。A theme change causes an invalidation of the control template and the contained visual tree, which in turn causes the entire control to unload and reload. したがって、ページが最初にページへの移動によって読み込まれた場合にのみ、Loaded を発生させることはできません。Therefore Loaded cannot be assumed to occur only when a page is first loaded through navigation to the page.

ルーティングされたイベント情報Routed Event Information

識別子フィールドIdentifier field LoadedEvent
ルーティング方法Routing strategy 直接Direct
委任Delegate RoutedEventHandler