Guia de início rápido: adicionando configurações de aplicativo usando o Tempo de Execução do Windows

[ Este artigo destina-se aos desenvolvedores do Windows 8.x e do Windows Phone 8.x que escrevem aplicativos do Windows Runtime. Se você estiver desenvolvendo para o Windows 10, consulte documentação mais recente]

Este início rápido o conduz pela implementação do contrato de Configurações usando as classes do Tempo de Execução do Windows. Entretanto, recomendamos que você siga as etapas do Guia de início rápido: adicionando configurações de aplicativo usando a Biblioteca do Windows para JavaScript. Se você está criando um aplicativo usando C++/C#/VB e XAML, confira Guia de início rápido: Adicionar configurações ao aplicativo.

Pré-requisitos

Leia as Diretrizes para configurações de aplicativos.

1. Especificar os comandos a serem expostos em Configurações

  1. Ouça o evento do painel de configurações CommandsRequested.

  2. Especifique os comandos no retorno de chamada associado. Para cada comando:

    1. Forneça um SettingsCommand.Id e um SettingsCommand.Label localizado.
    2. Defina o manipulador (SettingsCommand.Invoked) para o evento que será acionado quando o usuário escolher o comando.
    3. Acrescente o objeto SettingsCommand ao vetor ApplicationCommands para disponibilizá-lo para o SettingsPane.

2. Mostrar as configurações personalizadas apropriadas quando o usuário pedir por elas

  • Mostre a interface do usuário das configurações definidas pelo aplicativo apropriadas em resposta à invocação do usuário por um comando de configurações.
  • Mantenha a interface do usuário para isso simples e destituível com um toque, para manter o usuário no contexto de aplicativo atual.
  • Reflita as mudanças de configurações no aplicativo instantaneamente.
  • Mostra a interface do usuário de configurações no mesmo lado em que o botão aparece verificando a propriedade SettingsEdgeLocation.

Resumo

Neste início rápido, você aprendeu as duas etapas de alto nível na configuração do contrato de Configurações usando as classes do Tempo de Execução do Windows.

Tópicos relacionados

Exemplos

Amostra de configurações do aplicativo

Referência

Windows.UI.ApplicationSettings

Documentos

Início rápido: Usando a Biblioteca do Windows para JavaScript

Diretrizes de configurações de aplicativos.