次の方法で共有


CoreApplication クラス

定義

アプリが状態の変更を処理し、ウィンドウを管理し、さまざまな 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
属性

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 インスタンスにルーティングされる基になるエラーがある場合に発生します。

適用対象

こちらもご覧ください