LauncherOptions Kelas

Definisi

Ruang nama:

Windows.System

Menentukan opsi yang digunakan untuk meluncurkan aplikasi default untuk file atau URI.

Di aplikasi desktop, sebelum menggunakan instans kelas ini dengan cara yang menampilkan UI, Anda harus mengaitkan objek dengan handel jendela pemiliknya. Untuk informasi selengkapnya, dan contoh kode, lihat Menampilkan objek UI WinRT yang bergantung pada CoreWindow.

public ref class LauncherOptions sealed : ILauncherViewOptions

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class LauncherOptions final : ILauncherViewOptions

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Activatable(65536, "Windows.Foundation.UniversalApiContract")]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class LauncherOptions : ILauncherViewOptions

function LauncherOptions()

Public NotInheritable Class LauncherOptions
Implements ILauncherViewOptions

Warisan

Object Platform::Object IInspectable LauncherOptions

Atribut

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Penerapan

ILauncherViewOptions

Persyaratan Windows

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

Contoh

Lihat contoh kode dalam topik LaunchUriAsync(Uri, LauncherOptions).

Keterangan

Dalam beberapa kasus, ketika Anda memanggil Launcher metode statis untuk meluncurkan aplikasi yang terkait dengan jenis file atau protokol URI, Anda harus menentukan dengan tepat aplikasi mana yang ingin Anda luncurkan dengan meneruskan parameter LauncherOptions dengan properti TargetApplicationPackageFamilyName diatur ke nama keluarga paket untuk paket aplikasi yang berisi aplikasi tersebut.

Dua kasus tersebut adalah sebagai berikut:

1. Anda ingin meluncurkan aplikasi dengan URI dan meneruskan data input tambahan ke aplikasi yang diluncurkan, menggunakan Launcher.LaunchUriAsync(Uri, LauncherOptions, ValueSet).
2. Anda ingin meluncurkan aplikasi dengan URI dan menunggu aplikasi mengirim data output kembali ke aplikasi Anda, menggunakan kelebihan beban Launcher.LaunchUriForResultsAsync.

Dalam kasus ini, aplikasi panggilan dan aplikasi yang diluncurkan perlu menyetujui cara menginterpretasikan data tambahan yang diteruskan dari satu aplikasi ke aplikasi lainnya. Aplikasi panggilan tidak dapat meluncurkan aplikasi apa pun yang kebetulan menjadi default untuk protokol URI tersebut. Dalam kasus lain, properti TargetApplicationPackageFamilyName bersifat opsional.

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1607	14393	IgnoreAppUriHandlers
1703	15063	LimitPickerToCurrentAppAndAppUriHandlers

Konstruktor

LauncherOptions()

Membuat dan menginisialisasi instans baru objek opsi peluncur. Di aplikasi desktop, sebelum menggunakan instans kelas ini dengan cara yang menampilkan UI, Anda harus mengaitkan objek dengan handel jendela pemiliknya. Untuk informasi selengkapnya, dan contoh kode, lihat Menampilkan objek UI WinRT yang bergantung pada CoreWindow.

Properti

ContentType	Mendapatkan atau mengatur tipe konten yang terkait dengan URI yang mewakili file di jaringan.
DesiredRemainingView	Luncurkan aplikasi target dan biarkan aplikasi sumber yang sedang berjalan tetap berada di layar dengan berbagi ruang secara merata dengan aplikasi target atau dengan mengambil lebih banyak atau kurang ruang daripada aplikasi target.
DisplayApplicationPicker	Mendapatkan atau menetapkan nilai yang menunjukkan apakah akan menampilkan dialog Buka Dengan setiap kali API peluncuran asosiasi dipanggil.
FallbackUri	Mendapatkan atau menetapkan nilai yang mewakili URI yang harus dibawa pengguna ke browser jika tidak ada aplikasi untuk menangani jenis file atau URI.
IgnoreAppUriHandlers	Menunjukkan apakah akan mengabaikan handler yang dapat menangani skema http (seperti browser). Sebaliknya, peluncuran akan kembali ke browser default.
LimitPickerToCurrentAppAndAppUriHandlers	Mendapatkan atau mengatur apakah akan membatasi pemilih untuk peluncur ke aplikasi saat ini dan handler URI terkait.
NeighboringFilesQuery	Memungkinkan aplikasi mengakses file yang terkait dengan file yang digunakan untuk mengaktifkan aplikasi.
PreferredApplicationDisplayName	Mendapatkan atau menetapkan nilai yang mewakili nama tampilan aplikasi di penyimpanan yang harus diinstal pengguna jika tidak ada aplikasi untuk menangani jenis file atau URI.
PreferredApplicationPackageFamilyName	Mendapatkan atau menetapkan nilai yang mewakili nama keluarga paket aplikasi di Store yang harus diinstal pengguna jika tidak ada aplikasi untuk menangani jenis file atau URI.
TargetApplicationPackageFamilyName	Nama keluarga paket dari paket target yang harus digunakan untuk meluncurkan file atau URI. Properti ini bersifat opsional dalam beberapa kasus. LihatKomentar .
TreatAsUntrusted	Mendapatkan atau menetapkan nilai yang menunjukkan apakah sistem harus menampilkan peringatan bahwa file atau URI berpotensi tidak aman saat memulai aplikasi yang terkait dengan file atau URI.
UI	Mendapatkan opsi antarmuka pengguna (UI) saat memulai aplikasi default.

Lihat juga

• LaunchFileAsync(IStorageFile, LauncherOptions)
• LaunchUriAsync(Uri, LauncherOptions)
• sampel peluncuran Asosiasi
• Luncurkan aplikasi default untuk file
• Meluncurkan aplikasi default untuk URI
• Panduan untuk jenis file dan URI