Uruchamianie strony Ustawień aplikacji domyślnych
Dowiedz się, jak uruchomić aplikację Ustawienia systemu Windows przy użyciu schematu identyfikatora URI ms-settings, aby wyświetlić stronę Ustawień domyślnych aplikacji z twojej aplikacji.
System Windows definiuje zestaw identyfikatorów URI, które umożliwiają aplikacjom uruchamianie aplikacji Ustawienia systemu Windows i wyświetlanie określonej strony ustawień. W tym artykule wyjaśniono, jak uruchomić aplikację Ustawienia systemu Windows bezpośrednio na stronie Ustawienia domyślne, a opcjonalnie przejdź bezpośrednio do ustawień określonej aplikacji domyślnej. Aby uzyskać więcej informacji, zobacz Uruchamianie aplikacji Ustawienia systemu Windows.
Adres URL ustawień domyślnych aplikacji
ms-settings:defaultapps uruchamia aplikację Ustawienia systemu Windows i przechodzi do strony ustawień Aplikacji domyślnych. Począwszy od systemu Windows 11 w wersji 21H2 (z aktualizacją zbiorczą z kwietnia 2023), 22H2 (z aktualizacją zbiorczą z kwietnia 2023) i 23H2 lub nowszych, można dodać dodatkowy parametr ciągu zapytania w formacie zakodowanego identyfikatora URI, aby przejść bezpośrednio do strony ustawień określonej aplikacji.
Istnieją trzy parametry ciągu zapytania. Parametr ciągu zapytania do użycia zależy od sposobu instalowania aplikacji.
| Parametr ciągu zapytania | Wartość do przekazania |
|---|---|
| zarejestrowanyUżytkownikAplikacji | Nazwana wartość z HKEY_CURRENT_USER\Software\RegisteredApplications Użyj tego polecenia, gdy aplikacja została zainstalowana dla konkretnego użytkownika, a jej rejestracja została zapisana w HKEY_CURRENT_USER\Software\RegisteredApplications. |
| registeredAppMachine | Nazwa wartości z HKEY_LOCAL_MACHINE\Software\RegisteredApplications Użyj, kiedy aplikacja została zainstalowana na komputerze, a jej rejestracja została zapisana w HKEY_LOCAL_MACHINE\Software\RegisteredApplications. |
| registeredAUMID | Identyfikator modelu użytkownika aplikacji Użyj polecenia, gdy aplikacja została zarejestrowana w Menedżerze pakietów za pomocą manifestu deklarującego, że aplikacja obsługuje typy plików (uap:FileTypeAssociation) lub schematy URI (uap:Protocol). |
Notatka
Aby parametr ciągu zapytania registeredAUMID działał po uaktualnieniu systemu operacyjnego, może być konieczne zwiększenie wartości jego elementu TargetDeviceFamily...MaxVersionTested w manifeście. Dzięki temu aplikacja zostanie ponownie zindeksowana dla użytkownika, co z kolei zaktualizuje odpowiednie definicje używane do przetwarzania linku głębokiego za pośrednictwem aktywacji protokołu. Wartość MaxVersionTest powinna zostać zaktualizowana do 10.0.22000.1817 dla systemu Windows 11 w wersji 21H2 lub 10.0.22621.1555 dla systemu Windows 11 w wersji 22H2.
W poniższym przykładzie LaunchUriAsync jest wywoływana w celu uruchomienia aplikacji Ustawienia systemu Windows. Identyfikator URI ms-settings:defaultapps określa, że powinna być wyświetlana strona Ustawień domyślnych aplikacji. Następnie określana jest aplikacja, która ma zostać uruchomiona. Na przykład "Microsoft Edge" został zarejestrowany w aplikacji HKEY_LOCAL_MACHINE\Software\RegisteredApplications. Ponieważ jest to aplikacja zainstalowana na maszynie, registeredAppMachine jest parametrem ciągu zapytania, który powinien być używany. Opcjonalny parametr ciągu zapytania registeredAppMachine jest ustawiony na zarejestrowaną nazwę, przeformatowaną poprzez wywołanie funkcji Url.EscapeDataString, aby wskazać, że strona dotycząca Microsoft Edge powinna być wyświetlana.
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")));
