Clase SplashScreen

SplashScreen Class

Proporciona una información de ubicación en imagen y del evento de descarte para la pantalla de presentación de la aplicación.

Sintaxis


/* Para obtener información acerca de la creación o el acceso a este objeto, vea los comentarios. */

Atributos

[Version(0x06020000)]

Members

A continuación se indican los tipos de miembros de SplashScreen (Clase):

Eventos

A continuación se indican los eventos de SplashScreen (Clase).

EventoDescripción
Dismissed Fires when the app's splash screen is dismissed.

 

Métodos

The SplashScreen Clase hereda métodos de Object Clase (C#/VB/C++).

Propiedades

SplashScreenClase tiene estas propiedades.

PropiedadTipo de accesoDescripción

ImageLocation

De sólo lecturaThe coordinates of the app's splash screen image relative to the window.

 

Comentarios

Tenga acceso a este objeto desde el controlador de eventos activado de la aplicación mediante la propiedad SplashScreen en el objeto de evento que se pasa al controlador.

Para JavaScript

Responda a los eventos onactivated en su controlador de eventos activado. Para obtener información sobre cómo responder a eventos activados, vea el tema sobre cómo activar una aplicación.

Si observa parpadeo durante la transición a la pantalla de presentación extendida, agregue onload="" en la etiqueta <img> de esta forma: <img id="extendedSplashImage" src="/images/splash-sdk.png" alt="Splash screen image" onload="" />. Esto ayuda a evitar el parpadeo al hacer que el sistema espere hasta que se haya presentado la imagen antes de cambiar a la pantalla de presentación extendida.

Además, si utiliza la carga de fragmentos para cargar una página extendida de la pantalla de presentación, todavía puede observar un parpadeo desde que se descarta la pantalla de presentación de Windows hasta que se muestra la página. Ve este parpadeo porque la carga del fragmento empieza a cargar la página de la pantalla de presentación de forma asincrónica, antes de que el controlador de eventos onactivated termine de ejecutarse. Puede evitar este molesto parpadeo si evita utilizar la carga de fragmentos para cargar la página extendida de la pantalla de presentación (como se muestra en el ejemplo de la pantalla de presentación). Cuando se completan las tareas adicionales de carga (también como muestra el ejemplo de la pantalla de presentación), puede navegar a la página principal de la aplicación. Como alternativa, si desea seguir usando la carga de fragmentos en la página extendida de la pantalla de presentación, también puede evitar el parpadeo si obtiene un aplazamiento de activación y responde a los eventos onactivated de forma asincrónica. Obtenga un aplazamiento para un evento iniciado llamando al método activatedOperation.getDeferral.

Para C#/C++/VB

Responda a los eventos Activated mediante la sobrecarga del método de control de eventos activado correspondiente. Por ejemplo, utilice OnLaunched para responder a los eventos de activación ActivationKind.Launch. Para obtener información sobre cómo responder a eventos activados, vea Cómo activar una aplicación.

Si observa parpadeo durante la transición a la pantalla de presentación extendida, vea la sección Solución de problemas en Instrucciones y lista de comprobación de presentación para obtener ayuda.

La propiedad SplashScreen está disponible en todas las clases Windows.ApplicationModel.Activation.

Ejemplos

En el ejemplo de pantalla de presentación se muestra cómo recuperar un objeto SplashScreen en el controlador de eventos activado al iniciar la aplicación.


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

Puede utilizar el objeto que se pasó al controlador de eventos activado para obtener información sobre el evento iniciado. En el ejemplo, el objeto contiene información sobre una activación launch y es un objeto webUILaunchActivatedEventArgs de JavaScript o un objeto LaunchActivatedEventArgs de C#/C++/VB), dependiendo del lenguaje de programación. La propiedad Kind de este objeto permite distinguir diferentes tipos de activación (como ActivationKind.launch o ActivationKind.search).

Requisitos

Cliente mínimo admitido

Windows 8 [Solo aplicaciones de la Tienda Windows]

Servidor mínimo admitido

Windows Server 2012 [Solo aplicaciones de la Tienda Windows]

Teléfono mínimo admitido

Windows Phone 8

Espacio de nombres

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

Metadatos

Windows.winmd

Vea también

Clases de Windows.ApplicationModel.Activation
Ejemplo de la pantalla de presentación
Activar y suspender la aplicación mediante el ejemplo de WinJS
Activar, reanudar y suspender una aplicación mediante el ejemplo de WRL
JavaScript
Inicio rápido: agregar una pantalla de presentación
Cómo activar una aplicación
Cómo extender la pantalla de presentación
C#/C++/VB
Inicio rápido: agregar una pantalla de presentación
Cómo activar una aplicación
Cómo extender la pantalla de presentación

 

 

Mostrar:
© 2017 Microsoft