SplashScreen Kelas

  • Referensi

Definisi

Ruang nama:
Windows.ApplicationModel.Activation
Edit

Menyediakan informasi peristiwa pemecatan dan lokasi gambar untuk layar percikan aplikasi.

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
Warisan
Object Platform::Object IInspectable SplashScreen
Atribut
ContractVersionAttribute

Persyaratan Windows

Rangkaian perangkat
Windows 10 (diperkenalkan dalam 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Contoh

Sampel layar Splash menunjukkan cara mengambil objek SplashScreen di penanganan aktivitas yang diaktifkan, saat aplikasi diluncurkan.

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

Anda dapat menggunakan objek yang diteruskan ke penanganan aktivitas yang diaktifkan untuk mendapatkan informasi tentang peristiwa yang diaktifkan. Dalam contoh, objek berisi informasi tentang aktivasi peluncuran dan merupakan objek webUILaunchActivatedEventArgs (JavaScript) atau objek LaunchActivatedEventArgs (C#/C++/VB), tergantung pada bahasa pemrograman. Properti Kind pada objek ini memungkinkan Anda membedakan antara berbagai jenis aktivasi (seperti ActivationKind.launch atau ActivationKind.search).

Keterangan

Akses objek ini dari penanganan aktivitas yang diaktifkan aplikasi Anda dengan menggunakan properti SplashScreen pada objek peristiwa yang diteruskan ke handler Anda.

Untuk JavaScript

Tanggapi peristiwa yang diaktifkan di penanganan aktivitas yang diaktifkan. Untuk mempelajari cara merespons peristiwa yang diaktifkan, lihat Siklus hidup aplikasi.

Jika Anda melihat kedipan selama transisi ke layar splash yang diperluas, tambahkan onload="" pada tag Anda seperti ini: <img id="extendedSplashImage" src="./windows.applicationmodel.activation/images/splash-sdk.png" alt="Splash screen image" onload="" />. Ini membantu mencegah berkedip dengan membuat sistem menunggu hingga gambar Anda dirender sebelum beralih ke layar percikan yang diperluas.

Selain itu, jika Anda menggunakan pemuatan fragmen untuk memuat halaman layar splash yang diperluas, Anda mungkin masih melihat berkedip antara ketika layar splash Windows ditutup dan ketika halaman Anda ditampilkan. Anda melihat kedipan ini karena pemuatan fragmen mulai memuat halaman layar percikan imitasi Anda secara asinkron, sebelum penanganan aktivitas yang diaktifkan selesai dieksekusi . Anda dapat mencegah kedipan mata ini dengan menghindari penggunaan pemuatan fragmen untuk memuat halaman layar splash yang diperluas (seperti yang ditunjukkan oleh sampel layar Splash). Saat tugas pemuatan tambahan Anda selesai (juga seperti yang ditunjukkan oleh sampel layar Splash), Anda kemudian dapat menavigasi ke halaman utama aplikasi Anda. Atau, jika Anda ingin melanjutkan penggunaan pemuatan fragmen di halaman layar splash yang diperluas, Anda juga dapat mencegah kedipan dengan mendapatkan penundaan aktivasi dan menanggapi peristiwa yang diaktifkan secara asinkron. Dapatkan penundaan untuk peristiwa yang diaktifkan dengan memanggil activatedOperation. metode getDeferral .

Untuk C#/C++/VB

Tanggapi peristiwa yang Diaktifkan dengan membebani metode penanganan aktivitas yang diaktifkan yang sesuai. Misalnya, gunakan OnLaunched untuk menanggapi peristiwa aktivasi ActivationKind.Launch . Untuk mempelajari cara merespons peristiwa yang diaktifkan, lihat Siklus hidup aplikasi.

Jika Anda melihat kedip selama transisi ke layar splash yang diperluas, lihat bagian Keterangan di Cara memperluas layar percikan (HTML) untuk mendapatkan bantuan.

Properti SplashScreen tersedia di semua kelas Windows.ApplicationModel.Activation .

Properti

ImageLocation

Koordinat gambar layar percikan aplikasi relatif terhadap jendela.

Acara

Dismissed

Diaktifkan saat layar splash aplikasi dimatikan.

Berlaku untuk

Lihat juga