LaunchActivatedEventArgs クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
public ref class LaunchActivatedEventArgs sealed : IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs, IPrelaunchActivatedEventArgs, IViewSwitcherProvider
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 : IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs, 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 : IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs, 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 IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs, IPrelaunchActivatedEventArgs, IViewSwitcherProvider
Public NotInheritable Class LaunchActivatedEventArgs
Implements IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs2, IPrelaunchActivatedEventArgs, IViewSwitcherProvider
- 継承
- 属性
- 実装
Windows の要件
| 要件 | 説明 |
|---|---|
| デバイス ファミリ |
Windows 10 (10.0.10240.0 で導入)
|
| API contract |
Windows.Foundation.UniversalApiContract (v1.0 で導入)
|
注釈
このオブジェクトは、ActivationKind が起動されたときにアクティブ化されたイベントに応答するとアクセスされます。
C++、C#、またはVisual Basicを使用する UWP アプリでは、通常、Application オブジェクトのメソッドをオーバーライドしてアクティブ化ポイントを実装します。 既定のテンプレート app.xaml 分離コード ファイルには、 常に OnLaunched のオーバーライドが含まれます。 既定の実装には、SuspensionManager ヘルパー クラスを使用した初期ナビゲーションのサポートと状態管理が含まれます。
アクティブ化シナリオに関連するすべての アプリケーション オーバーライドは、実装で Window.Activate を呼び出す必要があります。
アプリの起動に必要な時間が大幅に増加する可能性がある場合は、起動時にタスクを実行しないでください。 代わりに、 SplashScreen.Dismissed イベントをリッスンすることで、追加の読み込みタスクをトリガーできます。
アクティブ化の遅延オブジェクトは、アクティブ化中に複雑なタスクを完了するために使用しないでください。 アクティブ化中に発生した未処理のエラーまたは例外 (遅延アクティブ化を含む) は、アプリがクラッシュします。 アクティブ化中にネットワーク呼び出しを実行する必要がある場合、または多数の追加ファイルを処理する必要がある場合は、拡張スプラッシュ画面でアプリを起動してから、これらの操作を実行することを検討してください。 詳細については、「 スプラッシュ画面を長時間表示する方法」を参照してください。
Important
起動に時間がかかるアプリは、システムによって終了される可能性があります。
アプリをテストするときは、終了したばかりのアプリを直ちに再アクティブ化すると、スプラッシュ画面がまだ表示されている場合、アクティブ化に失敗することに注意してください。
JavaScript の起動の完了
JavaScript を使用したプログラミングの場合、起動タスクの実行後にアクティブ化されたイベント ハンドラーが正常に戻ったときに起動が完了します。
起動の完了.NET
C#、VB、または C++ を使用したプログラミングの場合は、アプリ ウィンドウをアクティブ化するときに起動が完了します。
バージョン履歴
| Windows のバージョン | SDK のバージョン | 付加価値 |
|---|---|---|
| 1607 | 14393 | TileActivatedInfo |
| 1607 | 14393 | User |
プロパティ
| Name | 説明 |
|---|---|
| Arguments |
起動のアクティブ化中にアプリに渡される起動引数を取得します。 |
| CurrentlyShownApplicationViewId |
現在表示されているアプリ ビューの識別子を取得します。 |
| Kind |
このアプリがアクティブ化されている理由を取得します。 |
| PrelaunchActivated |
アプリが事前に起動されたかどうかを示します。 |
| PreviousExecutionState |
このアクティブ化の前のアプリの実行状態を取得します。 |
| SplashScreen |
スプラッシュ画面からアクティブ化されたアプリへの切り替えに関する情報を提供するスプラッシュスクリーン オブジェクトを取得します。 |
| TileActivatedInfo |
ユーザーがタイルからアプリを起動したときに提供される追加情報を取得します。 タイルからアプリが起動されていない場合、またはこのプロパティをサポートしていないプラットフォームでアプリが起動された場合、これは null になります。 |
| TileId |
アプリを起動するために呼び出されたタイルの ID を取得します。 |
| User |
アプリがアクティブ化されたユーザーを取得します。 |
| ViewSwitcher |
アプリケーションのビューを設定できるビュー スイッチャー オブジェクトを取得します。 |