CoreApplication クラス

リファレンス

定義

名前空間:: Windows.ApplicationModel.Core

重要

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

編集

アプリが状態の変更を処理し、ウィンドウを管理し、さまざまな UI フレームワークと統合できるようにします。

public ref class CoreApplication abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class CoreApplication final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public static class CoreApplication

Public Class CoreApplication

継承: Object Platform::Object IInspectable CoreApplication

属性: ContractVersionAttribute MarshalingBehaviorAttribute

Windows の要件

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

注釈

このオブジェクトは、アプリの実行時にシングルトンとして作成されます。アプリケーション Single-Threaded アパートメント (ASTA) として実行されます。ビュープロバイダー (下のサンプルを参照) など、アプリシングルトンから作成されたスレッドは、マルチスレッドアパートメント (MTAThread) として属性付けする必要があります。

この API は、常に使用可能な Properties プロパティを除き、ユニバーサル Windows プラットフォームアプリでのみサポートされています。

struct App : implements<App, IFrameworkViewSource, IFrameworkView>
{
public:
    IFrameworkView CreateView()
    {
        return *this;
    }
};

...

int __stdcall wWinMain(HINSTANCE, HINSTANCE, PWSTR, int)
{
    Windows::ApplicationModel::Core::CoreApplication::Run(App());
}

ref class MyFrameworkViewSource : IFrameworkViewSource
{
public:
    virtual IFrameworkView^ CreateView()
    {
        return ref new MyFrameworkView();
    }
};

// ...

[Platform::MTAThread]
int main(Platform::Array<Platform::String^>^)
{
    auto frameworkViewSource = ref new MyFrameworkViewSource();
    Windows::ApplicationModel::Core::CoreApplication::Run(frameworkViewSource);
    return 0;
}

internal class ApplicationSource : IFrameworkViewSource
{
	public virtual IFrameworkView CreateView()
	{
		return new CoreApp();
	}
}

...

[MTAThread]
public static int Main()
{
	var appSource = new ApplicationSource();
	CoreApplication.Run(appSource);
	return 0;
}

バージョン履歴

Windows のバージョン	SDK バージョン	追加された値
1607	14393	BackgroundActivated
1607	14393	EnablePrelaunch
1607	14393	EnteredBackground
1607	14393	LeavingBackground
1709	16299	RequestRestartAsync
1709	16299	RequestRestartForUserAsync

プロパティ

Id	プロセスのパッケージ相対アプリ識別子を取得します。
MainView	この CoreApplication インスタンスを使用するすべての実行中のアプリの CoreApplicationView インスタンスメインを取得します。
Properties	プロセスの実行中にアプリと UI フレームワークが情報を格納するために使用できるプロパティセットを取得します。
Views	アプリのすべてのビューを取得します。

メソッド

CreateNewView()	アプリの新しいビューを作成します。
CreateNewView(IFrameworkViewSource)	アプリの新しいビューを作成します。
CreateNewView(String, String)	アプリの新しいビューを作成します。
DecrementApplicationUseCount()	この CoreApplication インスタンスを使用する実行中のアプリインスタンスの合計数をデクリメントします。
EnablePrelaunch(Boolean)	アプリを事前起動するオペレーティングシステムの機能を有効または無効にします。
Exit()	アプリをシャットダウンします。
GetCurrentView()	現在のスレッドに対応するビューを取得します。
IncrementApplicationUseCount()	この CoreApplication インスタンスを使用する実行中のアプリインスタンスの合計数をインクリメントします。
RequestRestartAsync(String)	アプリを再起動します。
RequestRestartForUserAsync(User, String)	別のユーザーのコンテキストでアプリを再起動します。
Run(IFrameworkViewSource)	外部ビュープロバイダーファクトリを実行して、ビュープロバイダーを取得します。
RunWithActivationFactories(IGetActivationFactory)	アクティブ化可能な型ファクトリを実行して、外部のアクティブ化可能な型を取得します。

イベント

BackgroundActivated	アプリがバックグラウンドトリガーによってアクティブ化されたときに発生します。
EnteredBackground	アプリがバックグラウンド状態で実行中に入ったときに発生します。
Exiting	アプリがシャットダウンするときに発生します。
LeavingBackground	アプリケーション UI が表示される直前に発生します。
Resuming	アプリが再開されるときに発生します。
Suspending	アプリが中断しているときに発生します。
UnhandledErrorDetected	グローバルエラー処理ロジックの一部として、CoreApplication インスタンスにルーティングされる基になるエラーがある場合に発生します。

適用対象