Application クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
アプリとその使用可能なサービスをカプセル化します。
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Application
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class Application
Public Class Application
<Application />
- 継承
- 属性
Windows の要件
デバイス ファミリ |
Windows 10 (10.0.10240.0 で導入)
|
API contract |
Windows.Foundation.UniversalApiContract (v1.0 で導入)
|
注釈
Application クラスはアプリをカプセル化し、次のサービスを提供します。
- アプリのエントリ ポイント(特にさまざまなアクティブ化コントラクト用)
- アプリの有効期間管理
- アプリ スコープのリソース
- 未処理の例外検出
Application オブジェクトは通常、App.xaml 用の最初の XAML で提供されます。 Visual Studio の既定のプロジェクト テンプレートは、Application から派生したクラスを App
生成し、初期化コードを追加できるエントリ ポイントを提供します。
クラスは App
、コンストラクターで生成された InitializeComponent
メソッドを呼び出すことによって、対応する XAML に自身を関連付けます。 コンストラクターに初期化コードを App
追加できますが、通常は、ハンドラーを Application イベントに関連付けるコードのみを追加します。 その他の初期化コードの場合は、 OnLaunched などの 1 つ以上の初期化メソッドをオーバーライドする必要があります。
システムは、ユーザーが別のアプリまたはデスクトップに切り替えるたびにアプリを中断し、ユーザーが切り替えるたびにアプリを再開することで、アプリの有効期間を処理します。 ただし、リソースを解放するために、中断中にアプリを終了することもできます。 終了した場合にアプリの状態を保存するには Suspending イベントを 処理し、 OnLaunched メソッドをオーバーライドしてアプリの状態を復元する必要があります。 再開イベントは、アプリが中断されている間に変更された可能性のある表示コンテンツを更新する必要がある場合にのみ処理する必要があります。 アプリの再開時に他のアプリの状態を復元する必要はありません。
アプリケーション モデル、codegen、およびアクティブ化シーケンスでの位置により、アプリケーションには XAML の使用に関するいくつかの制限があります。
- xmlns 宣言と x:Class 以外に、ルート タグに他の属性を
Application
表示することはできません。 - プロジェクト テンプレート App.xaml ページから 取得した x:Class 値を変更しないでください。ビルド アクションに存在する名前付けスキームの使用には、追加の依存関係があります。
- XAML でアプリケーション イベント ハンドラーを接続しないでください。 すべてのイベント配線は、コード (通常はコンストラクター) で行う必要があります。 また、通常は、イベントのイベント構文ではなくメソッドオーバーライドを使用します (たとえば、 OnActivated をオーバーライドして、アプリケーションライフ サイクルのそのフェーズに応答します)。
- XAML の Application インスタンスに必要なプロパティは、XAML プロパティ要素の使用法を使用して Application.Resources プロパティを設定する要素のセットのみです。 詳細については、「 リソース」を参照してください。 アプリ コードでキャッチされない例外に対して一般的なエラー処理を提供するには、 UnhandledException イベントを処理します。
Note
アプリケーション メイン ファイルには という名前を付App.xaml
ける必要があります。
バージョン履歴
Windows のバージョン | SDK バージョン | 追加された値 |
---|---|---|
1607 | 14393 | EnteredBackground |
1607 | 14393 | FocusVisualKind |
1607 | 14393 | LeavingBackground |
1607 | 14393 | OnBackgroundActivated |
1607 | 14393 | RequiresPointerMode |
1703 | 15063 | HighContrastAdjustment |
コンストラクター
Application() |
Application クラスの新しいインスタンスを初期化します。 |
プロパティ
Current |
現在の アプリケーションの Application オブジェクトを取得します。 |
DebugSettings |
デバッグ環境での実行時のアプリの動作を宣言する オブジェクトを取得します。 |
FocusVisualKind |
アプリがフォーカスのある UI 要素を示すために使用できる視覚的フィードバックの種類を取得または設定します。
|
HighContrastAdjustment |
ハイ コントラスト テーマが有効になっている場合に、フレームワークがビジュアル プロパティを自動的に調整するかどうかを示す値を取得または設定します。 |
RequestedTheme |
アプリのテーマ全体の明るい暗い設定を決定する値を取得または設定します。 |
RequiresPointerMode |
UWP アプリがマウス モードをサポートするかどうかを取得または設定します。これは、ゲーム パッドやリモート コントロールなどのポインター以外の入力デバイスでポインター操作エクスペリエンスをエミュレートします。 (入れ子になった要素はすべて、この動作を継承します)。 |
Resources |
スタイル、テンプレート、ブラシなど、アプリケーション スコープのリソースのコレクションを取得します。 |
メソッド
Exit() |
アプリをシャットダウンします。 |
LoadComponent(Object, Uri, ComponentResourceLocation) |
指定した相対位置にある XAML ファイルを読み込み、XAML ファイルのルート要素で指定された オブジェクトのインスタンスに変換します。 |
LoadComponent(Object, Uri) |
指定した相対位置にある XAML ファイルを読み込み、XAML ファイルのルート要素で指定された オブジェクトのインスタンスに変換します。 |
OnActivated(IActivatedEventArgs) |
通常の起動以外の何らかの方法でアプリケーションがアクティブ化されたときに呼び出されます。 |
OnBackgroundActivated(BackgroundActivatedEventArgs) |
アプリケーションがバックグラウンドでアクティブ化されたときに呼び出されます。 |
OnCachedFileUpdaterActivated(CachedFileUpdaterActivatedEventArgs) |
ActivationKind を CachedFileUpdater として使用したアクティブ化コントラクトが原因でアプリケーションがアクティブ化されたときに呼び出されます。 |
OnFileActivated(FileActivatedEventArgs) |
ファイルを開いてアプリケーションをアクティブ化するときに呼び出されます。 |
OnFileOpenPickerActivated(FileOpenPickerActivatedEventArgs) |
ファイルを開くダイアログの関連付けを使用してアプリケーションをアクティブ化するときに呼び出されます。 |
OnFileSavePickerActivated(FileSavePickerActivatedEventArgs) |
ファイル保存ダイアログの関連付けを使用してアプリケーションをアクティブ化するときに呼び出されます。 |
OnLaunched(LaunchActivatedEventArgs) |
アプリケーションの起動時に呼び出されます。 アプリケーションの初期化を実行し、関連付けられている Window に初期コンテンツを表示するには、このメソッドをオーバーライド します。 |
OnSearchActivated(SearchActivatedEventArgs) |
検索の関連付けを通じてアプリケーションがアクティブ化されたときに呼び出されます。 |
OnShareTargetActivated(ShareTargetActivatedEventArgs) |
アプリケーションが共有の関連付けを通じてアクティブ化されるときに呼び出されます。 |
OnWindowCreated(WindowCreatedEventArgs) |
アプリケーションがウィンドウを作成するときに呼び出されます。 |
Start(ApplicationInitializationCallback) |
エントリ ポイントを提供し、アプリケーションの初期化を要求します。 コールバックを使用して Application クラスをインスタンス化します。 |
イベント
EnteredBackground |
アプリがフォアグラウンドからバックグラウンドに移動したときに発生します。 |
LeavingBackground |
アプリがバックグラウンドからフォアグラウンドに移動したときに発生します。 |
Resuming |
アプリケーションが中断状態から実行中状態に移行したときに発生します。 |
Suspending |
アプリケーションが他の状態から中断状態に移行したときに発生します。 |
UnhandledException |
ネイティブ レベルのWindows ランタイム エラーから転送された例外をアプリ コードで処理できる場合に発生します。 アプリは、イベント データで処理済みとして発生をマークできます。 |