FrameworkElement.Loaded イベント

リファレンス

定義

名前空間:: Microsoft.UI.Xaml

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

編集

FrameworkElement が構築され、オブジェクトツリーに追加され、操作の準備ができたときに発生します。

// Register
event_token Loaded(RoutedEventHandler const& handler) const;

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

// Revoke with event_revoker
FrameworkElement::Loaded_revoker Loaded(auto_revoke_t, RoutedEventHandler const& handler) const;

public event RoutedEventHandler Loaded;

function onLoaded(eventArgs) { /* Your code */ }
frameworkElement.addEventListener("loaded", onLoaded);
frameworkElement.removeEventListener("loaded", onLoaded);
- or -
frameworkElement.onloaded = onLoaded;

Public Custom Event Loaded As RoutedEventHandler

<frameworkElement Loaded="eventhandler"/>

イベントの種類

RoutedEventHandler

例

および Unloaded のLoadedハンドラーは、サポートのためにプロジェクトテンプレートのクラスをNavigationHelper使用するすべてのページに自動的にアタッチされます。イベントの配線はコンストラクターで行われます。ハンドラーはラムダを使用して記述され、ページナビゲーションでマウスまたはキーボードイベントを使用できるように、他のイベントハンドラーをアタッチします。

this.Page.Loaded += (sender, e) =>
{
// Keyboard and mouse navigation only apply when occupying the entire window
if (this.Page.ActualHeight == Window.Current.Bounds.Height &&
    this.Page.ActualWidth == Window.Current.Bounds.Width)
    {
        // Listen to the window directly so focus isn't required
        Window.Current.CoreWindow.Dispatcher.AcceleratorKeyActivated +=
            CoreDispatcher_AcceleratorKeyActivated;
            Window.Current.CoreWindow.PointerPressed +=
            this.CoreWindow_PointerPressed;
    }
};

このイベントは Loaded 、テーマアニメーションやその他のトリガーに関連付けられていない装飾アニメーションを開始するのに適したタイミングです。この例では、アニメーションストーリーボードで Begin を呼び出すメソッドにハンドラーをLoaded接続して、XAML で PointAnimation をトリガーする方法を示します。

<Canvas Width="450" Height="350">
    <Canvas.Resources>
        <Storyboard x:Name="myStoryboard">

            <!-- Animate the center point of the ellipse from 100 X, 300 Y
             to 400 X, 100 Y over 5 seconds. -->
            <PointAnimation
             Storyboard.TargetProperty="Center"
             Storyboard.TargetName="MyAnimatedEllipseGeometry"
             Duration="0:0:5" 
             From="100,300"
             To="400,100"
             RepeatBehavior="Forever" EnableDependentAnimation="True"/>

        </Storyboard>
    </Canvas.Resources>
    <Path Fill="Blue" Loaded="Start_Animation">
        <Path.Data>

            <!-- Describes an ellipse. -->
            <EllipseGeometry x:Name="MyAnimatedEllipseGeometry"
             Center="200,100" RadiusX="15" RadiusY="15" />
        </Path.Data>
    </Path>
</Canvas>

// Start the animation when the object loads
void SampleApp::Page::Start_Animation(Platform::Object^ sender, Windows::UI::Xaml::RoutedEventArgs^ e)
{
    myStoryboard->Begin();
}

// Start the animation when the object loads
private void Start_Animation(object sender, RoutedEventArgs e)
{
    myStoryboard.Begin();
}

注釈

このイベントでは、イベントデータとして RoutedEventHandler デリゲートと RoutedEventArgs が使用されますが、イベントはルーティングイベントではありません。これは、イベントの発生元の要素 (つまり 、送信者) でのみ処理できます。このイベントのイベントデータの OriginalSource は常に nullです。

読み込まれたとオブジェクトの有効期間

Windows アプリ SDK実装では、Loadedコントロールテンプレートが適用された後にイベントが発生することが保証され、XAML テンプレートを適用して作成されたオブジェクトへの参照を取得できます。

イベントは Loaded 、テンプレートから取得された要素にイベントハンドラーをフックしたり、適用されたテンプレートの結果である子要素の存在に依存するロジックを呼び出したりするためのポイントとして使用できます。 Loaded は、UI の XAML コントロールを表示する前に、アプリコードで要素ツリー構造を操作するために推奨されるオブジェクトの有効期間イベントです。また、初期レイアウトでも発生する他のイベントがない場合は、Loaded ハンドラーから VisualStateManager.GoToState メソッドを呼び出して、テンプレートで定義されている初期ビューステートを設定することも適切です (SizeChanged は初期レイアウトで発生します)。

Windows アプリ SDK実装ののタイミングLoadedは、Windows Presentation Foundation (WPF) 実装でのタイミングと似ています。これに対し、Microsoft Silverlight の実装では、発生したときに Loaded 読み込まれるテンプレートに依存できないタイミングの問題がありました。これらの XAML フレームワークから XAML または分離コードを移行する場合は、ハンドラーでLoaded行う操作を、Windows アプリ SDK実装のテンプレート読み込みタイミングに適したものに調整できます。

適用されたテンプレートから取得した項目にアクセスするには、 VisualTreeHelper 静的メソッドを使用し、インデックスによって子要素を移動できます。または、テンプレートコンテンツのルート要素で FindName メソッドを呼び出して、指定された x:Name 属性値を持つテンプレートの特定の部分を見つけることができます。コントロール自体ではなく、テンプレートルートで FindName を呼び出す必要があることに注意してください。これは、そのテンプレートに固有のテンプレートによってオブジェクトが作成されるたびに XAML 名前スコープが作成されるためです (詳細については、「 XAML 名前スコープ」を参照してください)。テンプレートルートにアクセスするには、をtarget使用VisualTreeHelper.GetChild(target,0)して、はテンプレートが適用されるオブジェクトです。そのルートを取得したら、その後、名前付きパーツにアクセスできます。

既存のコントロールから派生する場合は、インスタンスごとに処理 Loaded するのではなく、 OnApplyTemplate をオーバーライドして、動作を既定のクラス動作の一部にすることができます。 OnApplyTemplate は、適用されたテンプレートからオブジェクトのツリーがあり、ビジュアルを調べたり調整したりするこの状況のコールバックとして特に意図されています。これは、カスタムコントロールの動作の定義の重要な部分です。たとえば、開始ビジュアル状態の宣言や、イベント時オーバーライドパターンを使用して定義できないクラスハンドラーの配線などのアクションが含まれます。 1 つの違いは、 OnApplyTemplate スコープから GetTemplateChild を使用して、FindName ではなく名前付きパーツを検索する必要がある点です。

LayoutUpdated は関連イベントです。 LayoutUpdated イベントは、コントロールを有効にするシーケンスの最後の "オブジェクトの有効期間" イベントであり、の後にLoaded発生します。ただし、 LayoutUpdated は、ツリー内の連続する親だけでなく、レイアウト変更に関連するオブジェクトに対して発生します。 UI 内のいくつかのオブジェクトはすべて、LayoutUpdated を同時に起動する可能性があります。レイアウトの変更は、ユーザーがビューステートや画面解像度を変更する、同じ UI またはレイアウトコンテナー内の他の要素のプログラムによるサイズ変更など、さまざまな理由で発生します。このため、は通常、 Loaded 初期レイアウトまたは適用されたテンプレートで動作するコードを実行する場合に適しています。

ページ間のナビゲーションを使用するアプリコードの場合は、移動先ページのコントロールの要素操作または状態変更に Page.OnNavigatedTo を使用しないでください。この仮想メソッドは、テンプレートが読み込まれる前に呼び出されるため、テンプレートの要素はまだ使用できません。代わりに、新しく読み込まれたページのコンテンツのルートにイベントハンドラーをアタッチ Loaded し、イベントハンドラーで Loaded 要素の操作、状態の変更、イベントの配線などを実行します。

適用対象

FrameworkElement.Loaded イベント

定義

イベントの種類

例

注釈

読み込まれたとオブジェクトの有効期間

適用対象

こちらもご覧ください

フィードバック

フィードバック

その他のリソース