SplashScreen Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
- Atribut
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
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk