Buka halaman pengaturan untuk Aplikasi Default

Pelajari cara meluncurkan Pengaturan Windows untuk menampilkan halaman pengaturan Aplikasi Bawaan dari aplikasi Anda menggunakan skema URI ms-settings.

Windows menentukan sekumpulan URI yang memungkinkan aplikasi meluncurkan Pengaturan Windows dan menampilkan halaman pengaturan tertentu. Artikel ini menjelaskan cara meluncurkan Pengaturan Windows langsung ke halaman pengaturan Aplikasi Default dan, secara opsional, menavigasi langsung ke pengaturan untuk aplikasi default tertentu. Untuk informasi selengkapnya, lihat Meluncurkan Pengaturan Windows.

URL Pengaturan Default Aplikasi

ms-settings:defaultapps meluncurkan Pengaturan Windows dan menavigasi ke halaman pengaturan Aplikasi Default. Dimulai dengan Windows 11, versi 21H2 (dengan Pembaruan Kumulatif 2023-04), 22H2 (dengan Pembaruan Kumulatif 2023-04), dan 23H2 atau yang lebih baru, Anda dapat menambahkan parameter string kueri tambahan dalam format URI yang lolos untuk diluncurkan langsung ke halaman pengaturan untuk aplikasi tertentu.

Ada tiga parameter string kueri. Parameter string kueri yang akan digunakan tergantung pada cara aplikasi diinstal.

Parameter kueri string	Nilai yang akan diteruskan
penggunaAplikasiTerdaftar	Nama nilai dari HKEY_CURRENT_USER\Software\RegisteredApplications Gunakan saat aplikasi diinstal per pengguna, dan pendaftaran untuk aplikasi ditulis ke HKEY_CURRENT_USER\Software\RegisteredApplications.
mesinAplikasiTerdaftar	Nilai bernama dari HKEY_LOCAL_MACHINE\Software\RegisteredApplications Gunakan saat aplikasi diinstal per komputer, dan pendaftaran untuk aplikasi ditulis ke HKEY_LOCAL_MACHINE\Software\RegisteredApplications.
registeredAUMID	ID Model Pengguna Aplikasi Gunakan saat aplikasi terdaftar di Package Manager menggunakan manifes yang menyatakan bahwa aplikasi menangani Jenis File (uap:FileTypeAssociation) atau skema URI (uap:Protocol).

Nota

Untuk mendapatkan parameter string kueri registeredAUMID agar bisa berfungsi setelah peningkatan OS, aplikasi mungkin perlu mengubah nilai versi TargetDeviceFamily...MaxVersionTested dalam manifesnya. Ini akan memastikan bahwa aplikasi diindeks ulang untuk pengguna, yang pada gilirannya akan memperbarui definisi yang sesuai yang digunakan untuk memproses tautan mendalam melalui aktivasi protokol. MaxVersionTested harus diperbarui ke 10.0.22000.1817 untuk Windows 11, versi 21H2 atau 10.0.22621.1555 untuk Windows 11, versi 22H2.

Dalam contoh berikut, LaunchUriAsync dipanggil untuk meluncurkan Pengaturan Windows. Uri ms-settings:defaultapps menentukan bahwa halaman pengaturan Aplikasi Default harus ditampilkan. Selanjutnya, aplikasi yang harus diluncurkan ditentukan. Sebagai contoh, "Microsoft Edge" didaftarkan oleh aplikasi di HKEY_LOCAL_MACHINE\Software\RegisteredApplications. Karena ini adalah aplikasi yang diinstal per mesin, registeredAppMachine adalah parameter string kueri yang harus digunakan. Parameter string kueri opsional registeredAppMachine diatur ke nama terdaftar, lolos dengan panggilan ke Url.EscapeDataString, untuk menentukan bahwa halaman untuk Microsoft Edge harus ditampilkan.

private async void LaunchSettingsPage_Click(object sender, RoutedEventArgs e)
{
    bool result = await Windows.System.Launcher.LaunchUriAsync(new Uri("ms-settings:defaultapps?registeredAppMachine=" + Uri.EscapeDataString("Microsoft Edge")));
}

bool result = co_await Windows::System::Launcher::LaunchUriAsync(Windows::Foundation::Uri(L"ms-settings:defaultapps?registeredAppMachine=" + Uri::EscapeDataString(L"Microsoft Edge")));

Konten terkait

Luncurkan Pengaturan Windows

Meluncurkan aplikasi bawaan untuk URI