Partager via


SplashScreen Classe

Définition

Fournit un événement de congédiement et des informations d’emplacement d’image pour l’écran de démarrage de l’application.

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
Héritage
Object Platform::Object IInspectable SplashScreen
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Exemples

L’exemple d’écran de démarrage montre comment récupérer un objet SplashScreen dans son gestionnaire d’événements activé lors du lancement de l’application.

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

Vous pouvez utiliser l’objet passé à votre gestionnaire d’événements activé pour obtenir des informations sur l’événement activé. Dans l’exemple, l’objet contient des informations sur une activation de lancement et est un objet webUILaunchActivatedEventArgs (JavaScript) ou LaunchActivatedEventArgs (C#/C++/VB), selon le langage de programmation. La propriété Kind de cet objet vous permet de faire la distinction entre différents types d’activation (comme ActivationKind.launch ou ActivationKind.search).

Remarques

Accédez à cet objet à partir du gestionnaire d’événements activé de votre application à l’aide de la propriété SplashScreen sur l’objet d’événement passé dans votre gestionnaire.

Pour JavaScript

Répondre aux événements activés dans votre gestionnaire d’événements activés. Pour savoir comment répondre aux événements activés, consultez Cycle de vie de l’application.

Si vous remarquez un scintillement pendant la transition vers votre écran de démarrage étendu, ajoutez onload="" votre balise comme suit : <img id="extendedSplashImage" src="./windows.applicationmodel.activation/images/splash-sdk.png" alt="Splash screen image" onload="" />. Cela permet d’éviter le scintillement en faisant patienter le système jusqu’à ce que votre image ait été rendue avant qu’elle bascule vers votre écran de démarrage étendu.

En outre, si vous utilisez le chargement de fragments pour charger une page d’écran de démarrage étendue, vous pouvez toujours remarquer un scintillement entre le moment où l’écran de démarrage windows est ignoré et le moment où votre page est affichée. Vous voyez ce scintillement, car le chargement de fragments commence à charger votre page d’écran de démarrage d’imitation de manière asynchrone, avant la fin de l’exécution du gestionnaire d’événements onactivated . Vous pouvez empêcher ce scintillement disgracieux en évitant d’utiliser le chargement de fragments pour charger votre page d’écran de démarrage étendue (comme le montre l’exemple d’écran de démarrage). Une fois vos tâches de chargement supplémentaires terminées (également comme le montre l’exemple d’écran de démarrage), vous pouvez accéder à la page main de votre application. Si vous souhaitez continuer à utiliser le chargement de fragments dans votre page d’écran de démarrage étendue, vous pouvez également empêcher le scintillement en obtenant un report d’activation et en répondant aux événements activés de manière asynchrone. Obtenez un report pour un événement activé en appelant le activatedOperation. Méthode getDeferral .

Pour C#/C++/VB

Répondez aux événements activés en surchargeant la méthode de gestionnaire d’événements activé correspondante. Par exemple, utilisez OnLaunched pour répondre aux événements d’activation ActivationKind.Launch . Pour savoir comment répondre aux événements activés, consultez Cycle de vie de l’application.

Si vous remarquez un scintillement pendant la transition vers votre écran de démarrage étendu, consultez la section Remarques dans Comment étendre l’écran de démarrage (HTML) pour obtenir de l’aide.

La propriété SplashScreen est disponible sur toutes les classes Windows.ApplicationModel.Activation .

Propriétés

ImageLocation

Coordonnées de l’image de l’écran de démarrage de l’application par rapport à la fenêtre.

Événements

Dismissed

Se déclenche lorsque l’écran de démarrage de l’application est ignoré.

S’applique à

Voir aussi