LaunchActivatedEventArgs クラス

定義

名前空間:

Windows.ApplicationModel.Activation

アプリの起動時にイベント情報を提供します。

Javascript この型は 、WebUILaunchActivatedEventArgs として表示されます。

public ref class LaunchActivatedEventArgs sealed : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs2, IPrelaunchActivatedEventArgs, IViewSwitcherProvider

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class LaunchActivatedEventArgs final : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs2, IPrelaunchActivatedEventArgs, IViewSwitcherProvider

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class LaunchActivatedEventArgs : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs2, IPrelaunchActivatedEventArgs, IViewSwitcherProvider

Public NotInheritable Class LaunchActivatedEventArgs
Implements IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs2, IPrelaunchActivatedEventArgs, IViewSwitcherProvider

継承

Object Platform::Object IInspectable LaunchActivatedEventArgs

属性

ContractVersionAttribute MarshalingBehaviorAttribute

実装

IActivatedEventArgs IApplicationViewActivatedEventArgs ILaunchActivatedEventArgs IPrelaunchActivatedEventArgs IViewSwitcherProvider IActivatedEventArgsWithUser ILaunchActivatedEventArgs2

Windows の要件

デバイス ファミリ	Windows 10 (10.0.10240.0 で導入)
API contract	Windows.Foundation.UniversalApiContract (v1.0 で導入)

注釈

このオブジェクトは、ActivationKind が Launch のときにアクティブ化されたイベントに応答するとアクセスされます。

C++、C#、または Visual Basic を使用する UWP アプリは、通常、 Application オブジェクトのメソッドをオーバーライドすることでアクティブ化ポイントを実装します。 既定のテンプレート app.xaml 分離コード ファイルには、 常に OnLaunched のオーバーライドが含まれます。 既定の実装には、SuspensionManager ヘルパー クラスを使用した初期ナビゲーションサポートと状態管理が含まれます。

アクティブ化シナリオに関連するすべての アプリケーション オーバーライドは、実装で Window.Activate を呼び出す必要があります。

アプリの起動に必要な時間が大幅に長くなる可能性がある場合は、起動時にタスクを実行しないでください。 代わりに、 SplashScreen.Dismissed イベントをリッスンすることで、追加の読み込みタスクをトリガーできます。

アクティブ化の遅延オブジェクトは、アクティブ化中に複雑なタスクを完了するために使用しないでください。 アクティブ化中に発生する未処理のエラーまたは例外 (遅延アクティブ化を含む) は、アプリがクラッシュします。 アクティブ化中にネットワーク呼び出しを実行したり、多数の追加ファイルを処理したりする必要がある場合は、拡張スプラッシュ スクリーンにアプリを起動してから、これらの操作を実行することを検討してください。 詳細については、「 スプラッシュ スクリーンを長時間表示する方法」を参照してください。

重要

起動に過剰な時間が必要なアプリは、システムによって終了する可能性があります。

アプリをテストするときは、終了したばかりのアプリを直ちに再アクティブ化すると、スプラッシュスクリーンがまだ表示されている場合にアクティブ化に失敗します。

JavaScript 起動の完了

JavaScript を使用したプログラミングの場合、起動タスクの実行後にアクティブ化されたイベント ハンドラーが正常に戻ったときに起動が完了します。

.NET 起動の完了

C#、VB、または C++ を使用したプログラミングの場合、アプリ ウィンドウをアクティブ化するときに起動が完了します。

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1607	14393	TileActivatedInfo
1607	14393	ユーザー

プロパティ

Arguments	起動のアクティブ化中にアプリに渡される引数を取得します。
CurrentlyShownApplicationViewId	現在表示されているアプリ ビューの識別子を取得します。
Kind	このアプリがアクティブ化されている理由を取得します。
PrelaunchActivated	アプリが事前に起動されたかどうかを示します。
PreviousExecutionState	このアクティブ化の前のアプリの実行状態を取得します。
SplashScreen	スプラッシュ スクリーンからアクティブ化されたアプリへの切り替えに関する情報を提供するスプラッシュ スクリーン オブジェクトを取得します。
TileActivatedInfo	ユーザーがタイルからアプリを起動したときに提供される追加情報を取得します。 アプリがタイルから起動されていない場合、またはこのプロパティをサポートしていないプラットフォームでアプリが起動された場合、これは null になります。
TileId	アプリを起動するために呼び出されたタイルの ID を取得します。
User	アプリがアクティブ化されたユーザーを取得します。
ViewSwitcher	アプリケーションのビューを設定できるビュー スイッチャー オブジェクトを取得します。

こちらもご覧ください

• Activated
• Application
• OnLaunched(LaunchActivatedEventArgs)
• アプリのアクティブ化の処理