Bagikan melalui


Launcher Kelas

Definisi

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)]
class Launcher final
/// [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)]
public static class Launcher
[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

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.

Berlaku untuk

Lihat juga