Iniciar as Definições do Windows

Saiba como iniciar as Configurações do Windows. Este tópico descreve o esquema de ms-settings: URI. Use este esquema de URI para iniciar as Configurações do Windows em páginas de configurações específicas.

Abrir as Definições é uma parte importante de escrever uma aplicação que respeite a privacidade. Se seu aplicativo não puder acessar um recurso confidencial, recomendamos fornecer ao usuário um link conveniente para as configurações de privacidade desse recurso. Para obter mais informações, consulte Segurança e identidade.

APIs importantes

As seguintes APIs do Tempo de Execução do Windows (WinRT) são usadas neste tópico:

• LaunchUriAsync
• PreferredApplicationPackageFamilyName
• VistaRestanteDesejada

Note que as APIs do WinRT usadas neste tópico podem ser usadas tanto no WinUI como noutras aplicações de ambiente de trabalho. Para ler mais sobre como habilitar seu aplicativo da área de trabalho para trabalhar com APIs do WinRT, consulte Chamar APIs do Tempo de Execução do Windows em aplicativos da área de trabalho.

Como iniciar as Configurações

Para iniciar Configurações, use o ms-settings: esquema de URI conforme mostrado nos exemplos a seguir.

Controle de hiperlink XAML

Neste exemplo, um controle XAML de hiperlink é usado para iniciar a página de configurações de privacidade para o microfone usando o ms-settings:privacy-microphone URI.

<!--Set Visibility to Visible when access to the microphone is denied -->
<TextBlock x:Name="LocationDisabledMessage" FontStyle="Italic"
                 Visibility="Collapsed" Margin="0,15,0,0" TextWrapping="Wrap" >
          <Run Text="This app is not able to access the microphone. Go to " />
              <Hyperlink NavigateUri="ms-settings:privacy-microphone">
                  <Run Text="Settings" />
              </Hyperlink>
          <Run Text=" to check the microphone privacy settings."/>
</TextBlock>

Chamando LaunchUriAsync

Como alternativa, seu aplicativo pode chamar o método LaunchUriAsync para iniciar as configurações. Este exemplo mostra como iniciar a página de configurações de privacidade da câmera usando o ms-settings:privacy-webcam URI.

bool result = await Windows.System.Launcher.LaunchUriAsync(new Uri("ms-settings:privacy-webcam"));

bool result = co_await Windows::System::Launcher::LaunchUriAsync(Windows::Foundation::Uri(L"ms-settings:privacy-webcam"));

O código acima inicia a página de configurações de privacidade para a câmera:

Para saber mais sobre como iniciar URIs, veja Iniciar o aplicativo padrão para um URI.

ms-settings: Referência do esquema URI

As seções a seguir descrevem diferentes categorias de URIs ms-settings usados para abrir várias páginas de Configurações:

• Contas
• Aplicativos
• Centro de Controlo
• Devices
• Facilidade de acesso
• Extras
• Grupo Familiar
• Jogos
• Rede e internet
• Personalização
• Phone
• Privacidade
• Pesquisar
• Som
• System
• Hora e língua
• Atualização e segurança

A disponibilidade de algumas páginas de configurações varia de acordo com a versão do Windows e SKU. Para algumas configurações, a coluna URI também captura algumas informações de uso e quaisquer requisitos adicionais que devem ser atendidos para que uma página esteja disponível.

Accounts

Apps

Centro de Controlo

Dispositivos

Facilidade de acesso

Extras

Grupo Familiar

Jogos

Rede e internet

Personalização

Telemóvel

Privacidade

Pesquisa

Sound

System

Hora e língua

Atualização e segurança

Conteúdo relacionado

Iniciar a aplicação padrão para um URI

Iniciando, retomando e executando tarefas em segundo plano