Share via

LaunchActivatedEventArgs Kelas

  • Referensi

Definisi

Ruang nama:
Windows.ApplicationModel.Activation
Edit

Menyediakan informasi peristiwa saat aplikasi diluncurkan.

Javascript Jenis ini muncul sebagai WebUILaunchActivatedEventArgs.

public ref class LaunchActivatedEventArgs sealed : IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs, IPrelaunchActivatedEventArgs, IViewSwitcherProvider
public ref class LaunchActivatedEventArgs sealed : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs2, IPrelaunchActivatedEventArgs, IViewSwitcherProvider
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class LaunchActivatedEventArgs final : IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs, IPrelaunchActivatedEventArgs, IViewSwitcherProvider
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class LaunchActivatedEventArgs final : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs2, IPrelaunchActivatedEventArgs, IViewSwitcherProvider
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class LaunchActivatedEventArgs : IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs, IPrelaunchActivatedEventArgs, IViewSwitcherProvider
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class LaunchActivatedEventArgs : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs2, IPrelaunchActivatedEventArgs, IViewSwitcherProvider
Public NotInheritable Class LaunchActivatedEventArgs
Implements IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs, IPrelaunchActivatedEventArgs, IViewSwitcherProvider
Public NotInheritable Class LaunchActivatedEventArgs
Implements IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs2, IPrelaunchActivatedEventArgs, IViewSwitcherProvider
Warisan
Object Platform::Object IInspectable LaunchActivatedEventArgs
Atribut
ContractVersionAttribute MarshalingBehaviorAttribute
Penerapan
IActivatedEventArgs IApplicationViewActivatedEventArgs ILaunchActivatedEventArgs IPrelaunchActivatedEventArgs IViewSwitcherProvider IActivatedEventArgsWithUser ILaunchActivatedEventArgs2

Persyaratan Windows

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

Keterangan

Objek ini diakses ketika Anda merespons peristiwa Diaktifkan ketika ActivationKindadalah Luncurkan.

Aplikasi UWP menggunakan C++, C#, atau Visual Basic biasanya menerapkan titik aktivasi dengan mengambil alih metode objek Aplikasi . File app.xaml code-behind templat default selalu menyertakan penimpaan untuk OnLaunched. Implementasi default mencakup dukungan navigasi awal dan manajemen status melalui kelas pembantu SuspensionManager.

Semua penimpaan Aplikasi yang terlibat dalam skenario aktivasi harus memanggil Window.Activate dalam implementasinya.

Hindari melakukan tugas selama peluncuran jika dapat secara signifikan meningkatkan waktu yang diperlukan untuk meluncurkan aplikasi Anda. Sebagai gantinya, Anda dapat memicu tugas pemuatan tambahan dengan mendengarkan peristiwa SplashScreen.Dismissed .

Objek penundaan aktivasi tidak boleh digunakan untuk menyelesaikan tugas kompleks selama aktivasi. Setiap kesalahan atau pengecualian yang tidak tertangani yang terjadi selama aktivasi (termasuk aktivasi yang ditangguhkan) akan menyebabkan aplikasi mengalami crash. Jika Anda perlu melakukan panggilan jaringan atau memproses sejumlah file tambahan selama aktivasi, pertimbangkan untuk meluncurkan aplikasi Anda ke layar splash yang diperluas lalu melakukan operasi ini. Untuk informasi selengkapnya, lihat Cara menampilkan layar splash untuk waktu yang lama.

Penting

Aplikasi yang membutuhkan waktu yang berlebihan untuk diluncurkan dapat dihentikan oleh sistem.

Saat menguji aplikasi Anda, ketahuilah bahwa segera mengaktifkan kembali aplikasi yang baru saja dihentikan akan mengakibatkan aktivasi yang gagal jika layar splash masih terlihat.

Penyelesaian peluncuran JavaScript

Jika pemrograman dengan JavaScript, peluncuran selesai saat penanganan aktivitas yang diaktifkan berhasil dikembalikan setelah menjalankan tugas peluncuran Anda.

Penyelesaian peluncuran .NET

Jika pemrograman dengan C#, VB, atau C++, peluncuran selesai saat Anda mengaktifkan jendela aplikasi.

Riwayat versi

Versi Windows Versi SDK Nilai ditambahkan
1607 14393 TileActivatedInfo
1607 14393 Pengguna

Properti

Arguments

Mendapatkan argumen yang diteruskan ke aplikasi selama aktivasi peluncurannya.
CurrentlyShownApplicationViewId

Mendapatkan pengidentifikasi untuk tampilan aplikasi yang saat ini ditampilkan.
Kind

Mendapatkan alasan bahwa aplikasi ini sedang diaktifkan.
PrelaunchActivated

Menunjukkan apakah aplikasi telah diluncurkan sebelumnya.
PreviousExecutionState

Mendapatkan status eksekusi aplikasi sebelum aktivasi ini.
SplashScreen

Mendapatkan objek layar splash yang menyediakan informasi tentang transisi dari layar splash ke aplikasi yang diaktifkan.
TileActivatedInfo

Mendapatkan informasi tambahan yang disediakan saat pengguna meluncurkan aplikasi Anda dari petak peta. Ini akan null jika aplikasi tidak diluncurkan dari petak petanya atau jika aplikasi diluncurkan pada platform yang tidak mendukung properti ini.
TileId

Mendapatkan ID petak peta yang dipanggil untuk meluncurkan aplikasi.
User

Membuat pengguna tempat aplikasi diaktifkan.
ViewSwitcher

Mendapatkan objek pengalih tampilan yang memungkinkan Anda mengatur tampilan untuk aplikasi.

Berlaku untuk

Lihat juga