信息
您所需的主题如下所示。但此主题未包含在此库中。

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> 标记上添加如下所示的 onload=""<img id="extendedSplashImage" src="/images/splash-sdk.png" alt="Splash screen image" onload="" />。这样可以通过在您的图像切换为扩展初始屏幕之前,让系统等待直到图像显示的方法来防止闪烁。

此外,如果使用片段加载来加载扩展的初始屏幕页,您仍可以注意到关闭初始屏幕和显示页面之间的闪烁。在 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
快速入门:添加初始屏幕
如何激活应用程序
如何扩展初始屏幕

 

 

显示: