SplashScreen クラス

リファレンス

定義

名前空間:: Windows.ApplicationModel.Activation

重要

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

編集

アプリのスプラッシュスクリーンの無視イベントと画像の場所情報を提供します。

public ref class SplashScreen sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
class SplashScreen final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
public sealed class SplashScreen

Public NotInheritable Class SplashScreen

継承: Object Platform::Object IInspectable SplashScreen

属性: ContractVersionAttribute

Windows の要件

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

例

Splash screen サンプルは、アプリの起動時に、アクティブ化されたイベントハンドラーで SplashScreen オブジェクトを取得する方法を示しています。

protected override void OnLaunched(LaunchActivatedEventArgs args)
{
    if (args.PreviousExecutionState != ApplicationExecutionState.Running)
    {
        bool loadState = (args.PreviousExecutionState == ApplicationExecutionState.Terminated);
        ExtendedSplash extendedSplash = new ExtendedSplash(args.SplashScreen, loadState);
        Window.Current.Content = extendedSplash;
    }

    Window.Current.Activate();
}

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);

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

注釈

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

JavaScript の場合

アクティブ化されたイベントハンドラーで、アクティブ化されたイベントに応答します。アクティブ化されたイベントに応答する方法については、「アプリのライフサイクル」を参照してください。

拡張スプラッシュ画面への切り替え中にちらつきが発生した場合は、次のようにタグを追加onload=""します。 <img id="extendedSplashImage" src="./windows.applicationmodel.activation/images/splash-sdk.png" alt="Splash screen image" onload="" /> これにより、拡張スプラッシュ画面に切り替わる前にイメージがレンダリングされるまでシステムを待機させることで、ちらつきを防ぐことができます。

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

C#/C++/VB の場合

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

拡張スプラッシュ画面への切り替え中にちらつきが発生する場合は、「スプラッシュスクリーン (HTML) を拡張する方法」の「解説」セクションを参照してください。

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

プロパティ

ImageLocation

ウィンドウに対するアプリのスプラッシュスクリーンイメージの座標。

イベント

Dismissed

アプリのスプラッシュスクリーンが閉じられたときに発生します。

適用対象