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:

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.

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:

Uma captura de ecrã das definições de privacidade da câmara do Windows.

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:

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

Página de configurações URI
Acesso ao trabalho ou à escola ms-settings:Local de trabalho
E-mail & contas de aplicativos ms-settings:email e contas
Família e outras pessoas ms-settings:outros utilizadores
Provisioning ms-settings:Provisionamento (disponível apenas em dispositivos móveis e se a empresa tiver implementado um pacote de provisionamento)
ms-settings:Provisionamento no local de trabalho (disponível apenas se a empresa tiver implementado um pacote de provisionamento)
Token de reparo ms-settings:workplace-repairtoken
Configurar um quiosque ms-settings:AsignedAccess
Opções de início de sessão ms-settings:opções de início de sessão
ms-settings:opçõesdeiníciodesessão-bloqueiodinâmico
Sincronizar as suas definições ms-settings:sincronização
ms-settings:Backup (Página de backup obsoleta no Windows 11)
Windows em Qualquer Lugar ms-settings:WindowsAnywhere (o dispositivo deve ser compatível com Windows Anywhere)
Configuração do Windows Hello ms-settings:opçõesdeiníciodesessão-iniciarregistofacial
ms-settings:opçõesdeiníciodesessão-iniciarregistodeimpressãodigital
As suas informações ms-settings:a tua informação

Apps

Página de configurações URI
Aplicações & Funcionalidades ms-settings:Aplicações e funcionalidades
Funcionalidades da aplicação ms-settings:appsfeatures-app (Reiniciar, gerir conteúdos adicionais e descarregáveis, etc. para a aplicação)

Para aceder a esta página com um URI, utilize o URI ms-settings:appsfeatures-app e forneça, opcionalmente, o nome da família de pacotes da aplicação como parâmetro.

Exemplo: ms-settings:appsfeatures-app?<PFN>
Aplicações para websites ms-settings:aplicações para sites
Aplicações predefinidas ms-settings:defaultapps (Comportamento introduzido no Windows 11, versão 21H2 (com Atualização Cumulativa 2023-04) ou 22H2 (com Atualização Cumulativa 2023-04), ou posterior.)
Anexe o parâmetro de cadeia de caracteres de consulta nos seguintes formatos usando o nome com escape de Uri de um aplicativo para iniciar diretamente a página de configurações padrão desse aplicativo:

- registeredAppMachine=<Uri-escaped por nome do aplicativo instalado na máquina>
- registeredAppUser=<Uri-escaped por nome de usuário instalado do aplicativo>
- registeredAUMID=<ID de Modelo de Usuário de Aplicativo codificado em Uri>

Para obter mais informações, consulte Iniciar a página Configurações padrão de aplicativos.
Configurações padrão do navegador ms-settings:defaultbrowsersettings (Descontinuado no Windows 11)
Gerenciar recursos opcionais ms-settings:Características opcionais
Mapas offline ms-settings:Mapas
ms-settings:mapas-downloadmaps (Descarregar mapas)
Aplicativos de inicialização ms-settings:startupapps
Reprodução de vídeo ms-settings:Reprodução de vídeo

Centro de Controlo

Página de configurações URI
Centro de controlo ms-settings:controlcenter

Dispositivos

Página de configurações URI
Reprodução Automática ms-settings:reprodução automática
Bluetooth ms-settings:Bluetooth
Dispositivos conectados ms-settings:dispositivos conectados
Câmera padrão ms-settings:câmara (Comportamento obsoleto no Windows 10, versão 1809 e posterior)
Configurações da câmera ms-settings:câmara (Comportamento introduzido no Windows 11, compilação 22000 e posteriores) Acrescente o parâmetro de cadeia de consulta cameraId com o nome da ligação simbólica de um dispositivo de câmara, escapado para URI, para abrir diretamente as definições dessa câmara. Para obter mais informações, consulte Iniciar a página de configurações da câmera.
Mouse e touchpad ms-settings:Mousetouchpad (definições do touchpad disponíveis apenas em dispositivos com touchpad)
Caneta & Windows Ink ms-settings:caneta
Botão de atalho da caneta ms-settings:Botão de caneta
Impressoras & scanners ms-settings:Impressoras
Touch ms-settings:Dispositivos-toque
Touchpad ms-settings:Dispositivos - Touchpad (disponível apenas se houver hardware do touchpad presente)
Sugestões de texto ms-settings:dispositivosescritatecladofísicosugestõesdetexto
Digitação ms-settings:Dactilografia
USB ms-settings:USB
Roda ms-settings:roda (disponível apenas se um dispositivo Surface Dial estiver emparelhado)
O seu telemóvel ms-settings:dispositivos móveis

Facilidade de acesso

Página de configurações URI
Áudio ms-settings:facilidade de acesso-áudio
Legendas ocultas ms-settings:Facilidadede de Acesso - Legendas Ocultas
Filtros de cor ms-settings:facilidadede de acesso-colorfilter
ms-settings:facilidadedeacesso-colorfilter-adaptativocolorlink
ms-settings:facilidadede de acesso-colorfilter-bluelightlink
Ecrã ms-settings:Facilidade de Acesso-Ecrã
Controlo ocular ms-settings:facilidade de acesso-controlo ocular
Aparelhos auditivos ms-settings:Acessibilidade - aparelhos auditivos (Adicionado ao Windows 11, versão 24H2)
Alto contraste ms-settings:Facilidade de Acesso - Alto Contraste
Keyboard ms-settings:Facilidade de acesso - teclado
Lupa ms-settings:Facilidade de Acesso - Lupa
Mouse ms-settings:facilidadede acesso - rato
Ponteiro do rato & toque ms-settings:facilidade de acesso-ponteiro do rato
Narrador ms-settings:facilidadede acesso-narradorou
ms-settings:facilidadede de acesso-narrador-isautostart ativado
Voz ms-settings:facilidade de acesso-reconhecimento de fala
Cursor de texto ms-settings:cursor de Facilidade de Acesso
Efeitos visuais ms-settings:facilidadede de acesso - efeitos visuais

Extras

Página de configurações URI
Extras ms-settings:Extras (Só disponíveis se aplicações com estas definições tiverem sido instaladas, por exemplo, por terceiros)

Grupo Familiar

Página de configurações URI
Grupo Familiar ms-settings:Grupo familiar

Jogos

Página de configurações URI
Barra de jogo ms-settings:gaming-gamebar
DVR de Jogos ms-settings:gaming-gamedvr
Modo de Jogo ms-settings:Modo de jogo
Jogar um jogo em ecrã inteiro ms-settings:Silencimomentosjogo
TruePlay ms-settings:gaming-trueplay (A partir do Windows 10, versão 1809 (10.0; Build 17763), esta funcionalidade foi removida do Windows)
Página de configurações URI
Áudio e fala ms-settings:áudio-holográfico
Meio Ambiente ms-settings:Ambiente-Holográfico de Privacidade
Ecrã do auricular ms-settings:Auscultador holográfico
Uninstall ms-settings:Gestão holográfica
Início e ambiente de trabalho ms-settings:holographic-startupandesktop

Rede e internet

Página de configurações URI
Rede & internet ms-settings:Estado da rede
Configurações avançadas ms-settings:Configurações avançadas de rede
Modo avião ms-settings:Modo de Avião de Rede.
ms-settings:Proximidade
Telemóvel & SIM ms-settings:rede celular
Acesso telefónico ms-settings:Network-Dialup
DirectAccess ms-settings:network-directaccess (disponível apenas se o DirectAccess estiver ativado)
Ethernet ms-settings:rede Ethernet
Gerenciar redes conhecidas ms-settings:rede-definições de Wi‑Fi
Hotspot móvel ms-settings:rede-ponto de acesso móvel
Proxy ms-settings:Network-Proxy
VPN ms-settings:network-vpn
Wi-Fi ms-settings:Network-WiFi (disponível apenas se o dispositivo tiver um adaptador Wi-Fi)
Configuração de Wi-Fi ms-settings:Provisionamento WiFi

Personalização

Página de configurações URI
Contexto geral ms-settings:personalização-fundo
Escolha quais pastas aparecem na tela inicial ms-settings:Personalização-Início-Lugares
Colors ms-settings:personalização-cores
ms-settings:Cores
Personalizar a tecla Copilot no teclado ms-settings:personalização-texto-entrada-copiloto-chave de hardware
Iluminação dinâmica ms-settings:personalização da iluminação
Fontes ms-settings:Tipos de letra
Visão rápida ms-settings:personalization-glance (Descontinuado no Windows 10, versão 1809 e posteriores)
Ecrã de bloqueio ms-settings:Ecrã de bloqueio
Barra de navegação ms-settings:personalization-navbar (Descontinuado no Windows 10, versão 1809 e posteriores)
Personalização (categoria) ms-settings:Personalização
Start ms-settings:início da personalização
Taskbar ms-settings:Barra de tarefas
Entrada de texto ms-settings:personalização-entrada de texto
Teclado Tátil ms-settings:Personalização-Teclado Tátil
Themes ms-settings:Temas

Telemóvel

Página de configurações URI
Ligação Telefónica ms-settings:dispositivos móveis
ms-settings:dispositivos móveis-adicionar telefone
ms-settings:mobile-devices-addphone-direct (Abre a aplicação Phone Link )
Utilização do dispositivo ms-settings:Utilização do dispositivo

Privacidade

Página de configurações URI
Aplicações acessórias ms-settings:privacy-accessoryapps (Obsoleto no Windows 10, versão 1809 e posteriores)
Informações da conta ms-settings:privacy-accountinfo
Histórico de atividade ms-settings:privacidade-histórico de atividade
ID de publicidade ms-settings:privacy-advertisingid (Obsoleto no Windows 10, versão 1809 e posteriores)
Diagnóstico de aplicativos ms-settings:privacy-appdiagnostics
Downloads automáticos de arquivos ms-settings:privacidade-transferências automáticas de ficheiros
Aplicativos em segundo plano ms-settings:privacy-backgroundapps (Descontinuado no Windows 11, 21H2 e posteriores)

Observação: No Windows 11, as permissões do aplicativo em segundo plano são acessadas individualmente. Para ver as permissões, aceda a Aplicações> instaladas e, em seguida, selecione "..." numa aplicação moderna e escolha Opções avançadas. A página avançada está presente para aplicativos modernos e a seção Permissões de aplicativos em segundo plano estará presente, a menos que uma política de grupo tenha sido definida ou o valor de alternância global do usuário (a configuração preterida do Windows 10) esteja definido. Para acessar esta página com um URI, use o ms-settings:appsfeatures-app URI e passe um parâmetro opcional do nome da família do pacote do aplicativo.
Perceção Espacial de Fundo ms-settings:Privacidade-ContextoPerceção Espacial
Calendário ms-settings:calendário-privacidade
Histórico de chamadas ms-settings:Privacidade-Histórico de Chamadas
Câmera ms-settings:webcam com privacidade
Contacts ms-settings:contactos-privacidade
Documents ms-settings:documentos de privacidade
Pasta de downloads ms-settings:privacidade-pasta-de-transferências
Email ms-settings:e-mail de privacidade
Rastreador ocular ms-settings:Privacy-eyetracker (requer hardware de eyetracker)
Feedback e diagnóstico ms-settings:comentários-sobre-privacidade
Sistema de ficheiros ms-settings:Privacidade-Acesso alargado ao sistema de ficheiros
General ms-settings:Privacidade ou ms-settings:Privacidade Geral
Gráficos ms-settings:privacidade-capturagráficaprogramática
ms-settings:privacidade-capturagráficasemrebordo
Escrita à tinta e digitação ms-settings:Privacidade - Ditado por voz
Localização ms-settings:privacidade-localização
Messaging ms-settings:Mensagens de privacidade
Microfone ms-settings:microfone com privacidade
Motion ms-settings:Movimento de privacidade
Biblioteca de Música ms-settings:Privacidade-Biblioteca de Música
Notifications ms-settings:notificações de privacidade
Outros dispositivos ms-settings:privacidade-dispositivospersonalizados
Chamadas telefónicas ms-settings:Chamadas telefónicas privadas
Pictures ms-settings:imagens privadas
Rádios ms-settings:rádios de privacidade
Voz ms-settings:Privacidade da fala
Tasks ms-settings:tarefas de privacidade
Videos ms-settings:Vídeos sobre privacidade
Ativação por voz ms-settings:Ativação por voz da privacidade
Página de configurações URI
Pesquisa ms-settings:Pesquisa
Pesquisar mais detalhes ms-settings:pesquisar-mais detalhes
Permissões de pesquisa ms-settings:permissões de pesquisa

Sound

Página de configurações URI
Misturador de volume ms-settings:apps-volume
Sound ms-settings:Som
Dispositivos de som ms-settings:Dispositivos sonoros
Microfone padrão ms-settings:som-propriedades predefinidas de entrada
Saída de áudio padrão ms-settings:sound-defaultoutputproperties
Propriedades do dispositivo de áudio
(dispositivo específico)
ms-settings:sound-properties?endpointId={0.0.0.00000000}.{aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb}

Observação: O usuário do URI deve conhecer a endpointId cadeia de caracteres a ser usada.
Propriedades do dispositivo de áudio
(dispositivo específico)
ms-settings:sound-properties?interfaceId=\\?\SWD#MMDEVAPI#{3.0.0.00000003}.{bbbbbbbb-1111-2222-3333-cccccccccccc}#{cccccccc-2222-3333-4444-dddddddddddd}

Observação: O utilizador do URI deve saber a interfaceId cadeia de caracteres a ser usada e a cadeia de caracteres deve ser codificada corretamente antes de ser enviada.

System

Página de configurações URI
Sobre nós ms-settings:Acerca de
Configurações avançadas de exibição ms-settings:Display-Advanced (disponível apenas em dispositivos que suportam opções avançadas de visualização)
Economia de bateria ms-settings:Poupador de bateria (disponível apenas em dispositivos com bateria, como um tablet)
Configurações de economia de bateria ms-settings:Configurações de poupança de bateria (disponível apenas em dispositivos com bateria, como um tablet)
Utilização da bateria ms-settings:Detalhes de uso do economizador de bateria (disponível apenas em dispositivos com bateria, como um tablet)
Área de transferência ms-settings:Prancheta
Locais de salvamento padrão ms-settings:Localizações guardadas
Ecrã ms-settings:Ecrã
ms-settings:Rotação do ecrã
Duplicar o meu ecrã ms-settings:apresentação de momentos tranquilos
Durante estas horas ms-settings:momentos de silêncio agendados
Encryption ms-settings:Encriptação de dispositivos
Recomendações em matéria de energia ms-settings:recomendações de energia (Disponível na atualização Moment de fevereiro para o Windows 11, Versão 22H2, Compilação 22624 ou posterior)
Assistência de foco ms-settings:horas de silêncio
Configurações gráficas ms-settings:display-advancedgraphics (disponível apenas em dispositivos que suportam opções gráficas avançadas)
Configurações padrão de gráficos ms-settings:ecrã-gráficosavançados-predefinido
Multitarefa ms-settings:multitarefa
ms-settings:multitarefa-sgupdate
Configurações de luz noturna ms-settings:Luz noturna
Projetando para este PC ms-settings:projeto
Experiências partilhadas ms-settings:entre dispositivos
Modo Tablet ms-settings:Tabletmode (Removido no Windows 11)
Taskbar ms-settings:Barra de tarefas
Notificações e ações ms-settings:notificações
Ambiente de Trabalho Remoto ms-settings:Ambiente de trabalho remoto
Telemóvel ms-settings:phone (obsoleto no Windows 10, versão 1809 e posterior)
Alimentação e suspensão ms-settings:modo de suspensão
Deteção de presença ms-settings:presença (Adicionado na atualização May Moment para Windows 11, Versão 22H2, Build 22624)
Armazenamento ms-settings:storagesense
Sensor de armazenamento ms-settings:políticas de armazenamento
Recomendações de armazenamento ms-settings:Recomendacións de armazenamento
Discos & volumes ms-settings:discos e volumes

Hora e língua

Página de configurações URI
Data & hora ms-settings:data e hora
Configurações do IME do Japão ms-settings:regionlanguage-jpnime (disponível se o editor de métodos de entrada da Microsoft Japan estiver instalado)
Região ms-settings:regionformatting
Linguagem ms-settings:Teclado
ms-settings:teclado-avançado
ms-settings:regiãoidioma
ms-settings:regionlanguage-bpmfime
ms-settings:regionlanguage-cangjieime
ms-settings:regionlanguage-chsime-wubi-udp
ms-settings:regionlanguage-quickime
ms-settings:regiãolíngua-korime
Configurações do IME Pinyin ms-settings:regionlanguage-chsime-pinyin (disponível se o editor de métodos de entrada Microsoft Pinyin estiver instalado)
ms-settings: regionlanguage-chsime-pinyin-domainlexicon
ms-settings:regionlanguage-chsime-pinyin-keyconfig
ms-settings:regionlanguage-chsime-pinyin-udp
Voz ms-settings:Discurso
Configurações do IME do Wubi ms-settings:regionlanguage-chsime-wubi (disponível se o editor de métodos de entrada Wubi do Microsoft estiver instalado)

Atualização e segurança

Página de configurações URI
Activation ms-settings:Ativação
Backup ms-settings:Cópia de segurança (página removida do Windows 11; abre a Sincronização)
Otimização da Entrega ms-settings:entrega-otimização
ms-settings:entrega-otimização-atividade
ms-settings:entrega-otimização-avançada
Localizar o meu dispositivo ms-settings:findmydevice
Para desenvolvedores ms-settings:Desenvolvedores
Recovery ms-settings:Recuperação
Iniciar o Registro de Chave de Segurança ms-settings:Opções de início de sessão - iniciar inscrição da chave de segurança
Troubleshoot ms-settings:Resolução de problemas
Segurança do Windows ms-settings:Windowsdefender
Programa Windows Insider ms-settings:WindowsInsider (presente apenas se o utilizador estiver inscrito em WIP)
ms-settings:windowsinsider-optin
Atualização do Windows ms-settings:WindowsUpdate
ms-settings:windowsupdate-action
Horas Ativas de Atualização do Windows ms-settings:windowsupdate-activehours
Opções Avançadas do Windows Update ms-settings:windowsupdate-options
Windows Update - Atualizações opcionais ms-settings:Windows Update-atualizações opcionais
Opções de Update-Restart do Windows ms-settings:windowsupdate-restartoptions
Windows Update-Seeker sob demanda ms-settings:WindowsUpdate-seekerondemand
Histórico de atualizações do Windows Update-View ms-settings:WindowsUpdate-história

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

Iniciando, retomando e executando tarefas em segundo plano