Freigeben über


SplashScreen Klasse

Definition

Stellt ein Kündigungsereignis und Bildspeicherortinformationen für den Begrüßungsbildschirm der App bereit.

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
Vererbung
Object Platform::Object IInspectable SplashScreen
Attribute

Windows-Anforderungen

Gerätefamilie
Windows 10 (eingeführt in 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

Das Begrüßungsbildschirmbeispiel veranschaulicht, wie ein SplashScreen-Objekt in seinem aktivierten Ereignishandler abgerufen wird, wenn die App gestartet wird.

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

Sie können das an Ihren aktivierten Ereignishandler übergebene Objekt verwenden, um Informationen zum aktivierten Ereignis abzurufen. Im Beispiel enthält das Objekt Informationen zu einer Startaktivierung und ist je nach Programmiersprache entweder ein webUILaunchActivatedEventArgs -Objekt (JavaScript) oder ein LaunchActivatedEventArgs -Objekt (C#/C++/VB). Mit der Kind-Eigenschaft für dieses Objekt können Sie zwischen verschiedenen Aktivierungstypen (z . B. ActivationKind.launch oder ActivationKind.search) unterscheiden.

Hinweise

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

Für JavaScript

Reagieren Sie auf onaktivierte Ereignisse in Ihrem aktivierten Ereignishandler. Informationen zum Reagieren auf aktivierte Ereignisse finden Sie unter App-Lebenszyklus.

Wenn Sie während des Übergangs zu Ihrem erweiterten Begrüßungsbildschirm ein Flackern bemerken, fügen Sie Ihrem Tag folgendes hinzu onload="" : <img id="extendedSplashImage" src="./windows.applicationmodel.activation/images/splash-sdk.png" alt="Splash screen image" onload="" />. Dies hilft, flackern zu verhindern, indem das System wartet, bis Ihr Bild gerendert wurde, bevor es zu Ihrem erweiterten Begrüßungsbildschirm wechselt.

Wenn Sie außerdem das Laden von Fragmenten zum Laden einer erweiterten Begrüßungsbildschirmseite verwenden, können Sie zwischen dem Schließen des Windows-Begrüßungsbildschirms und der Anzeige Ihrer Seite ein Flackern feststellen. Dieses Flackern wird angezeigt, da das Laden von Fragmenten beginnt, die Imitationsseite des Begrüßungsbildschirms asynchron zu laden, bevor der onaktivierte Ereignishandler die Ausführung beendet. Sie können dieses unschöne Flackern verhindern, indem Sie das Laden von Fragmenten zum Laden Der erweiterten Begrüßungsbildschirmseite vermeiden (wie im Beispiel des Begrüßungsbildschirms veranschaulicht). Wenn Ihre zusätzlichen Ladeaufgaben abgeschlossen sind (wie auch im Begrüßungsbildschirmbeispiel veranschaulicht), können Sie dann zur Standard Seite Ihrer App navigieren. Wenn Sie das Laden von Fragmenten auf der Seite des erweiterten Begrüßungsbildschirms fortsetzen möchten, können Sie das Flackern auch verhindern, indem Sie eine Aktivierungsverzögerung erhalten und asynchron auf aktivierte Ereignisse reagieren. Rufen Sie eine Verzögerung für ein aktiviertes Ereignis ab, indem Sie die activatedOperation aufrufen. getDeferral-Methode .

Für C#/C++/VB

Reagieren Sie auf aktivierte Ereignisse, indem Sie die entsprechende aktivierte Ereignishandlermethode überladen. Verwenden Sie beispielsweise OnLaunched , um auf Aktivierungsereignisse von ActivationKind.Launch zu reagieren. Informationen zum Reagieren auf aktivierte Ereignisse finden Sie unter App-Lebenszyklus.

Wenn Sie beim Übergang zu Ihrem erweiterten Begrüßungsbildschirm ein Flackern bemerken, finden Sie im Abschnitt Hinweise unter Erweitern des Begrüßungsbildschirms (HTML) Hilfe.

Die SplashScreen-Eigenschaft ist für alle Windows.ApplicationModel.Activation-Klassen verfügbar.

Eigenschaften

ImageLocation

Die Koordinaten des Begrüßungsbildschirmbilds der App relativ zum Fenster.

Ereignisse

Dismissed

Wird ausgelöst, wenn der Begrüßungsbildschirm der App geschlossen wird.

Gilt für:

Weitere Informationen