Compartir a través de


SplashScreen Clase

Definición

Proporciona información sobre el evento de descarte y la ubicación de la imagen para la pantalla de presentación de la aplicación.

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
Herencia
Object Platform::Object IInspectable SplashScreen
Atributos

Requisitos de Windows

Familia de dispositivos
Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

Ejemplos

En el ejemplo de pantalla de presentación se muestra cómo recuperar un objeto SplashScreen en su controlador de eventos activado, cuando se inicia la aplicación.

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

Puede usar el objeto pasado al controlador de eventos activado para obtener información sobre el evento activado. En el ejemplo, el objeto contiene información sobre una activación de inicio y es un objeto webUILaunchActivatedEventArgs (JavaScript) o un objeto LaunchActivatedEventArgs (C#/C++/VB), según el lenguaje de programación. La propiedad Kind de este objeto permite distinguir entre diferentes tipos de activación (como ActivationKind.launch o ActivationKind.search).

Comentarios

Acceda 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 eventos activados en el controlador de eventos activados. Para obtener información sobre cómo responder a eventos activados, consulte Ciclo de vida de la aplicación.

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

Además, si usa la carga de fragmentos para cargar una página de pantalla de presentación extendida, es posible que observe un parpadeo entre cuando se descarta la pantalla de presentación de Windows y cuando se muestra la página. Verá este parpadeo porque la carga de fragmentos comienza a cargar la página de pantalla de presentación de imitación de forma asincrónica, antes de que el controlador de eventos activado termine de ejecutarse. Puede evitar este parpadeo insightly evitando el uso de la carga de fragmentos para cargar la página de pantalla de presentación extendida (como se muestra en el ejemplo de pantalla de presentación). Una vez completadas las tareas de carga adicionales (también como se muestra en el ejemplo de pantalla de presentación), puedes navegar a la página principal de la aplicación. Como alternativa, si desea continuar con el uso de la carga de fragmentos en la página de pantalla de presentación extendida, también puede evitar que el parpadeo obtenga un aplazamiento de activación y responda a eventos activados de forma asincrónica. Obtenga un aplazamiento para un evento activado mediante una llamada a activatedOperation. Método getDeferral .

Para C#/C++/VB

Responda a eventos activados sobrecargando el método de controlador de eventos activado correspondiente. Por ejemplo, use OnLaunched para responder a los eventos de activación ActivationKind.Launch . Para obtener información sobre cómo responder a eventos activados, consulte Ciclo de vida de la aplicación.

Si observa un parpadeo durante la transición a la pantalla de presentación extendida, consulte la sección Comentarios en Cómo ampliar la pantalla de presentación (HTML) para obtener ayuda.

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

Propiedades

ImageLocation

Coordenadas de la imagen de la pantalla de presentación de la aplicación en relación con la ventana.

Eventos

Dismissed

Se activa cuando se descarta la pantalla de presentación de la aplicación.

Se aplica a

Consulte también