SplashScreen Class

Macht das Dismissed-Ereignis sowie Bildpositionsinformationen für den Begrüßungsbildschirm der App verfügbar.

Syntax


/* Weitere Informationen zum Erstellen oder Zugreifen auf dieses Objekt finden Sie unter "Hinweise". */

Attribute

[Version(0x06020000)]

Member

SplashScreenKlasse hat diese Membertypen:

Ereignisse

SplashScreenKlasse hat diese Ereignisse.

EreignisBeschreibung
Dismissed Fires when the app's splash screen is dismissed.

 

Methoden

The SplashScreen Klasse erbt Methoden von Object Klasse (C#/VB/C++).

Eigenschaften

Der SplashScreenKlasse hat diese Eigenschaften.

EigenschaftZugriffstypBeschreibung

ImageLocation

SchreibgeschütztThe coordinates of the app's splash screen image relative to the window.

 

Hinweise

Greifen Sie über den aktivierten Ereignishandler der App auf dieses Objekt zu, indem Sie die SplashScreen-Eigenschaft für das Ereignisobjekt verwenden, das an den Handler übergeben wird.

Für JavaScript

Reagieren Sie auf onactivated-Ereignisse in Ihrem aktivierten Ereignishandler. Informationen zum Reagieren auf aktivierte Ereignisse finden Sie unter So wird's gemacht: Aktivieren einer App.

Wenn Sie während des Übergangs zum erweiterten Begrüßungsbildschirm ein Flimmern bemerken, fügen Sie auf dem <img>-Tag den Wert onload="" wie folgt hinzu: <img id="extendedSplashImage" src="/images/splash-sdk.png" alt="Splash screen image" onload="" />. Dies hilft Flimmern zu vermeiden, indem das System so lange in den Wartezustand gesetzt wird, bis das Image vor der Anzeige auf dem erweiterten Begrüßungsbildschirm gerendert wurde.

Wenn Sie Fragmentladen verwenden, um eine erweiterte Begrüßungsbildschirmseite zu laden, sehen Sie möglicherweise weiterhin ein Flimmern zwischen dem Schließen des Windows-Begrüßungsbildschirms und der Anzeige der Seite. Sie sehen dieses Flimmern, da das Fragmentladen beginnt, die imitierte Begrüßungsbildschirmseite asynchron zu laden, bevor der onactivated-Ereignishandler die Ausführung beendet. Sie können dieses unansehnliche Flimmern verhindern, indem Sie das Fragmentladen nicht zum Laden der erweiterten Begrüßungsbildschirmseite verwenden (wie im Beispiel für einen Begrüßungsbildschirm dargestellt). Wenn die zusätzlichen Ladeaufgaben abgeschlossen sind (auch, wie im Begrüßungsbildschirmbeispiel gezeigt), können Sie zur Hauptseite der App navigieren. Alternativ können Sie das Flimmern auch verhindern, indem Sie eine Aktivierungsverzögerung abrufen und asynchron auf onactivated-Ereignisse reagieren, falls Sie das Fragmentladen auf der erweiterten Begrüßungsbildschirmseite fortsetzen möchten. Ausgewählte Ereignisse werden aufgeschoben, indem die activatedOperation.getDeferral-Methode aufgerufen wird.

Für C#/C++/VB

Reagieren Sie auf Activated-Ereignisse durch Überladen der entsprechenden aktivierten Ereignishandlermethode. Verwenden Sie beispielsweise OnLaunched, um auf ActivationKind.Launch-Aktivierungsereignisse zu reagieren. Informationen zum Reagieren auf aktivierte Ereignisse finden Sie unter So wird's gemacht: Aktivieren einer App.

Hilfe für den Fall, dass während des Übergangs zum erweiterten Begrüßungsbildschirm ein Flimmern auftritt, finden Sie im Abschnitt Problembehandlung im Thema Richtlinien und Prüfliste für Begrüßungsbildschirme.

Die SplashScreen-Eigenschaft ist auf allen Windows.ApplicationModel.Activation-Klassen verfügbar.

Beispiele

Das Begrüßungsbildschirmbeispiel veranschaulicht, wie ein SplashScreen-Objekt beim Starten der App im aktivierten Ereignishandler abgerufen wird.


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

Sie können das an den aktivierten Ereignishandler übergebene Objekt verwenden, um Informationen zum aktivierten Ereignis abzurufen. Im Beispiel enthält das Objekt Informationen über eine launch-Aktivierung und ist entweder ein webUILaunchActivatedEventArgs-Objekt (JavaScript) oder ein LaunchActivatedEventArgs-Objekt (C#/C++/VB), je nach Programmiersprache. Mit der Kind-Eigenschaft dieses Objekt können Sie zwischen verschiedenen Typen der Aktivierung (wie beispielsweise ActivationKind.launch oder ActivationKind.search) unterscheiden.

Anforderungen

Mindestens unterstützter Client

Windows 8 [Nur Windows Store-Apps]

Mindestens unterstützter Server

Windows Server 2012 [Nur Windows Store-Apps]

Mindestens unterstütztes Telefon

Windows Phone 8

Namespace

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

Metadaten

Windows.winmd

Siehe auch

Windows.ApplicationModel.Activation-Klassen
Begrüßungsbildschirmbeispiel
App aktivieren und mithilfe von WinJS-Beispiel halten
App aktiviert, Wiederaufnehmen und Anhalten mithilfe des WRL-Beispiels
JavaScript
Schnellstart: Hinzufügen eines Begrüßungsbildschirms
Aktivieren einer App
Erweitern des Begrüßungsbildschirms
C#/C++/VB
Schnellstart: Hinzufügen eines Begrüßungsbildschirms
Aktivieren einer App
Erweitern des Begrüßungsbildschirms

 

 

Anzeigen:
© 2015 Microsoft