Launcher Kelas

Definisi

Ruang nama:

Windows.System

Memulai aplikasi default yang terkait dengan file atau URI yang ditentukan.

public ref class Launcher abstract sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class Launcher final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Standard)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public static class Launcher

Public Class Launcher

Warisan

Object Platform::Object IInspectable Launcher

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Persyaratan Windows

Rangkaian perangkat	Windows 10 (diperkenalkan dalam 10.0.10240.0 - for Xbox, see UWP features that aren't yet supported on Xbox)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v1.0)

Contoh

Meluncurkan file yang terkandung dalam paket aplikasi

Lihat contoh kode dalam topik LaunchFileAsync(IStorageFile).

Meluncurkan URI

Lihat contoh kode dalam topik LaunchUriAsync(Uri).

Luncurkan dengan dialog peringatan

Contoh ini memanggil launchUriAsync(Uri, LauncherOptions) untuk meluncurkan URI dengan peringatan. Gunakan properti treatAsUntrusted untuk menunjukkan bahwa sistem harus menampilkan peringatan.

Catatan

Untuk aplikasi Windows yang menggunakan JavaScript, panggil preventDefault di penanganan aktivitas Anda jika properti treatAsUntrusted diatur dan Anda menggunakan elemen jangkar untuk meluncurkan URI.

function linkClickHandler(eventInfo) {
    var link = eventInfo.target;
    if (eventInfo.srcElement && (
        (eventInfo.type === "click") ||
        (eventInfo.type === "keydown" && (
        eventInfo.keyCode === WinJS.Utilities.Key.enter ||
        eventInfo.keyCode === WinJS.Utilities.Key.space)))) {
        eventInfo.preventDefault();
        if (link.href.indexOf("ms-appx") > -1) {
            WinJS.Navigation.navigate(link.href);
        }
        else if (link.href.indexOf("http") > -1) {
            // Create a Uri object from a URI string 
            var uri = new Windows.Foundation.Uri(link.href);
            var options = new Windows.System.LauncherOptions();
            // Launch the URI with a warning prompt
            options.treatAsUntrusted = true;
            // Launch the URI
            Windows.System.Launcher.launchUriAsync(uri, options).then(
                function (success) {
                    if (success) {
                        // URI launched
                    } else {
                        // URI launch failed
                    }
                });
        }
    }
}

Keterangan

Catatan

Kelas ini tidak tangkas, yang berarti Anda perlu mempertimbangkan model utas dan perilaku marshalingnya. Untuk informasi selengkapnya, lihat Threading dan Marshaling (C++/CX) dan Menggunakan objek Windows Runtime di lingkungan multithreaded (.NET).

Riwayat versi

Versi Windows	Versi SDK	Nilai ditambahkan
1607	14393	FindAppUriHandlersAsync
1607	14393	LaunchUriForResultsForUserAsync(User,Uri,LauncherOptions)
1607	14393	LaunchUriForResultsForUserAsync(User,Uri,LauncherOptions,ValueSet)
1607	14393	LaunchUriForUserAsync(User,Uri)
1607	14393	LaunchUriForUserAsync(User,Uri,LauncherOptions)
1607	14393	LaunchUriForUserAsync(User,Uri,LauncherOptions,ValueSet)
1607	14393	QueryAppUriSupportAsync(Uri)
1607	14393	QueryAppUriSupportAsync(Uri,String)
1809	17763	LaunchFolderPathAsync(String)
1809	17763	LaunchFolderPathAsync(String,FolderLauncherOptions)
1809	17763	LaunchFolderPathForUserAsync(User,String)
1809	17763	LaunchFolderPathForUserAsync(User,String,FolderLauncherOptions)

Metode

FindAppUriHandlersAsync(Uri)	Hitung penangan Pengidentifikasi Sumber Daya Seragam (URI) pada perangkat.
FindFileHandlersAsync(String)	Hitung penangan file pada perangkat.
FindUriSchemeHandlersAsync(String)	Menghitung penangan skema pada perangkat.
FindUriSchemeHandlersAsync(String, LaunchQuerySupportType)	Menghitung penangan skema pada perangkat.
LaunchFileAsync(IStorageFile)	Memulai aplikasi default yang terkait dengan file yang ditentukan.
LaunchFileAsync(IStorageFile, LauncherOptions)	Memulai aplikasi default yang terkait dengan file yang ditentukan, menggunakan opsi yang ditentukan.
LaunchFolderAsync(IStorageFolder)	Meluncurkan File Explorer dan menampilkan isi folder yang ditentukan.
LaunchFolderAsync(IStorageFolder, FolderLauncherOptions)	Meluncurkan File Explorer dengan opsi yang ditentukan dan menampilkan konten folder yang ditentukan.
LaunchFolderPathAsync(String)	Meluncurkan File Explorer dan menampilkan isi folder yang ditentukan.
LaunchFolderPathAsync(String, FolderLauncherOptions)	Meluncurkan File Explorer dengan opsi yang ditentukan dan menampilkan konten folder yang ditentukan.
LaunchFolderPathForUserAsync(User, String)	Meluncurkan File Explorer dan menampilkan isi folder yang ditentukan.
LaunchFolderPathForUserAsync(User, String, FolderLauncherOptions)	Meluncurkan File Explorer dengan opsi yang ditentukan dan menampilkan konten folder yang ditentukan.
LaunchUriAsync(Uri)	Memulai aplikasi default yang terkait dengan nama skema URI untuk URI yang ditentukan.
LaunchUriAsync(Uri, LauncherOptions)	Memulai aplikasi default yang terkait dengan nama skema URI atau yang ditentukan oleh ContentType untuk URI yang ditentukan, menggunakan opsi yang ditentukan.
LaunchUriAsync(Uri, LauncherOptions, ValueSet)	Memulai aplikasi default yang terkait dengan nama skema URI untuk URI yang ditentukan, menggunakan opsi dan data input yang ditentukan.
LaunchUriForResultsAsync(Uri, LauncherOptions)	Secara asinkron memulai aplikasi default yang terkait dengan nama skema URI untuk URI yang ditentukan, menggunakan opsi yang ditentukan.
LaunchUriForResultsAsync(Uri, LauncherOptions, ValueSet)	Secara asinkron memulai aplikasi default yang terkait dengan nama skema URI untuk URI yang ditentukan, menggunakan opsi dan data input yang ditentukan.
LaunchUriForResultsForUserAsync(User, Uri, LauncherOptions)	Secara asinkron memulai aplikasi default yang terkait dengan nama skema URI untuk URI yang ditentukan menggunakan opsi yang ditentukan, dan menyediakan Pengguna tertentu sebagai konteks.
LaunchUriForResultsForUserAsync(User, Uri, LauncherOptions, ValueSet)	Secara asinkron memulai aplikasi default yang terkait dengan nama skema URI untuk URI yang ditentukan menggunakan opsi dan data input yang ditentukan, dan menyediakan Pengguna tertentu sebagai konteks.
LaunchUriForUserAsync(User, Uri)	Memulai aplikasi multi-pengguna default yang terkait dengan nama skema URI untuk URI yang ditentukan dan menyediakan Pengguna tertentu sebagai konteks.
LaunchUriForUserAsync(User, Uri, LauncherOptions)	Memulai aplikasi multi-pengguna default yang terkait dengan nama skema URI untuk URI yang ditentukan menggunakan opsi yang ditentukan, dan menyediakan Pengguna tertentu sebagai konteks.
LaunchUriForUserAsync(User, Uri, LauncherOptions, ValueSet)	Memulai aplikasi multi-pengguna default yang terkait dengan nama skema URI untuk URI yang ditentukan, menggunakan opsi dan data input yang ditentukan, dan menyediakan Pengguna tertentu sebagai konteks.
QueryAppUriSupportAsync(Uri)	Secara asinkron mengkueri apakah ada aplikasi yang dapat menangani URI yang ditentukan.
QueryAppUriSupportAsync(Uri, String)	Secara asinkron mengkueri apakah aplikasi yang ditentukan dapat menangani URI yang ditentukan.
QueryFileSupportAsync(StorageFile)	Secara asinkron mengkueri apakah aplikasi dapat diaktifkan untuk file yang ditentukan.
QueryFileSupportAsync(StorageFile, String)	Secara asinkron mengkueri apakah aplikasi dengan nama paket yang ditentukan dapat diaktifkan untuk file yang ditentukan.
QueryUriSupportAsync(Uri, LaunchQuerySupportType)	Secara asinkron mengkueri apakah aplikasi dapat diaktifkan untuk URI yang ditentukan dan jenis peluncuran.
QueryUriSupportAsync(Uri, LaunchQuerySupportType, String)	Secara asinkron mengkueri apakah aplikasi dapat diaktifkan untuk URI, jenis peluncuran, dan nama paket yang ditentukan.

Lihat juga

• LauncherOptions
• LauncherUIOptions
• Meluncurkan aplikasi default untuk file
• Meluncurkan aplikasi default untuk URI
• Sampel peluncuran asosiasi
• Panduan untuk jenis file dan URI