LaunchActivatedEventArgs Kelas

Definisi

Ruang nama:

Windows.ApplicationModel.Activation

Menyediakan informasi peristiwa saat aplikasi diluncurkan.

Javascript Jenis ini muncul sebagai WebUILaunchActivatedEventArgs.

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 : 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 : IActivatedEventArgsWithUser, IApplicationViewActivatedEventArgs, ILaunchActivatedEventArgs2, 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.

Lihat juga

• Activated
• Application
• OnLaunched(LaunchActivatedEventArgs)
• Menangani aktivasi aplikasi