エクスポート (0) 印刷
すべて展開
情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

SplashScreen Class

アプリケーションのスプラッシュ スクリーンの解除イベントおよびイメージ位置情報を提供します。

構文


/* このオブジェクトの作成とアクセスについては、「解説」を参照してください。 */

属性

[Version(0x06020000)]

メンバー

SplashScreenクラス には次の種類のメンバーがあります。

イベント

SplashScreenクラス にはこれらのイベントがあります。

イベント説明
Dismissed Fires when the app's splash screen is dismissed.

 

メソッド

The SplashScreen クラス からメソッドを継承します。Object クラス (C#/VB/C++).

プロパティ

SplashScreenクラス には次のプロパティがあります。

プロパティアクセスの種類説明

ImageLocation

読み取り専用The coordinates of the app's splash screen image relative to the window.

 

解説

ハンドラーに渡されるイベント オブジェクトの SplashScreen プロパティを使用して、アプリケーションのアクティブ化されたイベント ハンドラーからこのオブジェクトにアクセスします。

JavaScript の場合

アクティブにしたイベント ハンドラーの onactivated イベントに応答します。アクティブ化済みイベントに応答する方法については、「アプリケーションをアクティブ化する方法」参照してください。

拡張スプラッシュ スクリーンへの遷移中にちらつきに気付いたら、<img id="extendedSplashImage" src="/images/splash-sdk.png" alt="Splash screen image" onload="" /> のように <img> タグに onload="" を追加します。これは、拡張スプラッシュ スクリーンへの切り替えを行わずにイメージがレンダリングされるまで待機することでちらつきを防止するために役立ちます。

また、フラグメントの読み込みを使用して、拡張されたスプラッシュ スクリーンのページを読み込んだ場合、Windows スプラッシュ スクリーンが閉じられてからページが表示されるまでの間にちらつきが発生する場合があります。このちらつきは、フラグメントの読み込みによって onactivated イベント ハンドラーの実行が終了する前にダミーのスプラッシュ スクリーン ページが非同期に読み込まれるために発生します。スプラッシュ スクリーンのサンプルに示すように、この見にくいちらつきを防止するには、拡大したスプラッシュ スクリーンのページの読み込みに、フラグメント読み込みを使用しないようにします。追加の読み込みタスクを完了したら (スプラッシュ スクリーン サンプルにも示すように)、アプリケーションのメイン ページに移動できます。また、拡張されたスプラッシュ スクリーンのページでラグメントの読み込みの使用を継続する場合、アクティベーション遅延の取得と onactivated イベントへの応答を非同期的に行うことにより、ちらつきを回避できます。activatedOperation.getDeferral メソッドを呼び出して、アクティブなイベントの遅延を取得します。

C#/C++/VB の場合

対応するアクティブにしたイベント ハンドラー メソッドをオーバーロードすることにより Activated イベントに応答します。たとえば、OnLaunched を使用して、ActivationKind.Launch のアクティブ化イベントに応答します。アクティブ化済みイベントに 応答する方法については、「アプリをアクティブ化する方法」参照してください。

拡張スプラッシュ画面への遷移中にちらつきに気付いた場合は、「スプラッシュ画面のガイドライン」の「トラブルシューティング」を参照してください。

SplashScreen プロパティは、すべての Windows.ApplicationModel.Activation クラスで使用できます。

スプラッシュ スクリーン サンプルは、アプリケーションの起動時の、アクティブ化されたイベント ハンドラー内の SplashScreen オブジェクトの取得方法を示します。


function activated(eventObject) {
    if (eventObject.detail.kind === Windows.ApplicationModel.Activation.ActivationKind.launch) {
        // Retrieve splash screen object
        splash = eventObject.detail.splashScreen;

        // Retrieve the window coordinates of the splash screen image.
        SdkSample.coordinates = splash.imageLocation;

        // Register an event handler to be executed when the splash screen has been dismissed.
        splash.addEventListener("dismissed", onSplashScreenDismissed, false);

        // Create and display the extended splash screen using the splash screen object.
        ExtendedSplash.show(splash);

        // Listen for window resize events to reposition the extended splash screen image accordingly.
        // This is important to ensure that the extended splash screen is formatted properly in response to snapping, unsnapping, rotation, etc...
        window.addEventListener("resize", onResize, false);

        // Use setPromise to indicate to the system that the splash screen must not be torn down
        // until after processAll and navigate complete asynchronously.
        eventObject.setPromise(WinJS.UI.processAll().then(function () {
            // Navigate to either the first scenario or to the last running scenario
            // before suspension or termination.
            var url = WinJS.Application.sessionState.lastUrl || scenarios[0].url;
            return WinJS.Navigation.navigate(url);
        }));
    }
}

// Register your activated event handler
WinJS.Application.addEventListener("activated", activated, false);

アクティブ化されたイベント ハンドラーに渡されたオブジェクトを使用すると、アクティブ化されたイベントについての情報が得られます。例では、オブジェクトに launch アクティベーションの情報が含まれます。このオブジェクトは、プログラミング言語に応じて webUILaunchActivatedEventArgs (JavaScript) オブジェクトまたは LaunchActivatedEventArgs (C#/C++/VB) オブジェクトになります。このオブジェクトの Kind プロパティは、アクティブ化の種類を区別できるようにします (ActivationKind.launchActivationKind.search など)。

要件

最小限サポートされるクライアント

Windows 8 [Windows ストア アプリのみ]

最小限サポートされるサーバー

Windows Server 2012 [Windows ストア アプリのみ]

最小限サポートされる携帯電話

Windows Phone 8

名前空間

Windows.ApplicationModel.Activation
Windows::ApplicationModel::Activation [C++]

メタデータ

Windows.winmd

参照

Windows.ApplicationModel.Activation クラス
スプラッシュ スクリーン サンプル
アプリケーションは、アクティブ化とサスペンドに WinJS サンプルを使用します。
WRL サンプルを使用してアクティブ化、再開、および中断されるアプリケーション
JavaScript
クイック スタート: スプラッシュ スクリーンの追加
アプリケーションをアクティブ化する方法
スプラッシュ スクリーンを拡張する方法
C#/C++/VB
クイック スタート: スプラッシュ スクリーンの追加
アプリケーションをアクティブ化する方法
スプラッシュ スクリーンを拡張する方法

 

 

表示:
© 2014 Microsoft