SplashScreen, classe

SplashScreen Class

Fournit des informations relatives à un événement d'abandon et à un emplacement d'image pour l'écran de démarrage de l'application.

Syntaxe


/* Pour plus d'informations sur la création ou l'accès à cet objet, consultez les notes. */

Attributs

[Version(0x06020000)]

Membres

SplashScreenClasse possède ces types de membres :

Événements

SplashScreenClasse possède ces événements.

ÉvénementDescription
Dismissed Fires when the app's splash screen is dismissed.

 

Méthodes

The SplashScreen Classe hérite des méthodes de Object Classe (C#/VB/C++).

Propriétés

Le SplashScreenClasse a les propriétés suivantes.

PropriétéType d'accèsDescription

ImageLocation

En lecture seuleThe coordinates of the app's splash screen image relative to the window.

 

Remarques

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

Pour JavaScript

Répondez aux événements onactivated dans votre gestionnaire d'événements activé. Pour savoir comment répondre aux événements activés, consultez la section relative au mode d'activation d'une application.

Si vous remarquez un scintillement lors de la transition vers votre écran de démarrage étendu, ajoutez onload="" à votre balise <img> comme suit : <img id="extendedSplashImage" src="/images/splash-sdk.png" alt="Splash screen image" onload="" />. Cela contribue à empêcher le scintillement en indiquant au système d'attendre que l'image ait été restituée avant de basculer vers votre écran de démarrage étendu.

En outre, si vous utilisez le chargement de fragment pour charger une page étendue de l'écran de démarrage, vous pouvez toujours remarquer un scintillement entre le moment où l'écran de démarrage Windows disparaît et le moment où la page s'affiche. Vous voyez ce scintillement parce que le chargement de fragment commence à charger votre page d'imitation de l'écran de démarrage de façon asynchrone, avant la fin de l'exécution du gestionnaire d'événements onactivated. Vous pouvez empêcher ce scintillement laid en évitant l'utilisation du chargement de fragment pour charger votre page étendue d'écran de démarrage (comme indiqué par l'Exemple d'écran de démarrage). Lorsque vos tâches de chargement supplémentaires sont terminées (comme indiqué également par l'Exemple d'écran de démarrage), vous pouvez ensuite accéder à la page principale de votre application. De même, si vous souhaitez continuer à utiliser le chargement de fragment dans votre page étendue de l'écran de démarrage, vous pouvez également empêcher le scintillement en obtenant un différé de lancement et en répondant aux événements onactivated de façon asynchrone. Obtient un différé pour un événement activé en appelant la méthode activatedOperation.getDeferral.

Pour C#/C++/VB

Répondez aux événements Activated en surchargeant la méthode de gestionnaire d'événements correspondante activée. 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 la section relative au mode d'activation d'une application.

Si vous remarquez un scintillement pendant la transition vers votre écran de démarrage étendu , consultez la section Résolution des problèmes dans Recommandations en matière d'écran de démarrage pour demander une assistance.

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

Exemples

L'Exemple d'écran de démarrage montre comment récupérer un objet SplashScreen dans son gestionnaire d'événements activé lorsque l'application démarre.


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 launch et est un objet webUILaunchActivatedEventArgs (JavaScript) ou LaunchActivatedEventArgs (C#/C++/VB), selon le langage de programmation. La propriété Kind sur cet objet vous permet de distinguer différents types d'activation (comme ActivationKind.launch ou ActivationKind.search).

Conditions requises

Client minimal pris en charge

Windows 8 [Applications Windows Store uniquement]

Serveur minimal pris en charge

Windows Server 2012 [Applications Windows Store uniquement]

Téléphone minimal pris en charge

Windows Phone 8

Espace de noms

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

Métadonnées

Windows.winmd

Voir aussi

Classes Windows.ApplicationModel.Activation
Exemple d'écran de démarrage
Activation et suspension d'application à l'aide de l'exemple WinJS
Applications activées, reprise et interruption à l'aide de l'exemple de WRL
JavaScript
Démarrage rapide : ajout d'un écran de démarrage
Comment activer une application
Comment étendre l'écran de démarrage
C#/C++/VB
Démarrage rapide : ajout d'un écran de démarrage
Comment activer une application
Comment étendre l'écran de démarrage

 

 

Afficher:
© 2017 Microsoft