Adicionando configurações de aplicativo

[ 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]

Use o contrato de Configurações para permitir que os usuários acessem as configurações de seu aplicativo usando o botão Configurações.

Por que usar o contrato de Configurações?

• Fornecer aos usuários acesso rápido e contextual às configurações que afetam seu aplicativo da Windows Store atual. Uma interface do usuário de configurações do tipo "light-dismiss" permite que os usuários ajustem rapidamente o comportamento do aplicativo e retomem a atividade de aplicativo anterior.
• Expor configurações específicas ao aplicativo junto com as configurações e as informações automaticamente expostas pelo sistema.
• Fornecer acesso à sua interface do usuário de configurações, sem sacrificar o real estado do aplicativo ou precisar criar navegação para/de uma página de configurações.

Todos os aplicativos da Windows Store participam automaticamente no contrato de Configurações. Mesmo se você nunca modificar as configurações do seu aplicativo, um usuário poderá clicar no botão Configurações de dentro de seu aplicativo e ver o painel Configurações padrão. Esse painel sempre tem 346 pixels de largura e contém uma lista de até sete comandos de configurações. Se um usuário clicar em um desses comandos, o submenu Configurações associado a esse comando substituirá o painel de Configurações na tela. Por padrão, o painel de Configurações fornecido pelo sistema inclui um comando "Permissões" e, depois que seu aplicativo é instalado, um comando "Avaliar e comentar", que envia feedback do usuário sobre seu aplicativo diretamente à Windows Store.

Além desses dois comandos padrão, é possível adicionar configurações personalizadas ao painel de Configurações exibido no seu aplicativo pelo Windows. Os tópicos a seguir mostram como criar um novo submenu Configurações (WinJS.UI.Flyout) para seu aplicativo e adicionar um comando personalizado ao painel de Configurações que vai abri-lo.

Se quiser tentar trabalhar com configurações de aplicativo e outros dos principais recursos do Windows 8, baixe os exercícios práticos para o Windows 8. Esses laboratórios apresentam uma introdução modular passo a passo de como criar um aplicativo da Windows Store de amostra na linguagem de programação de sua preferência (JavaScript e HTML ou C# e XAML).

Veja o exemplo: para obter um exemplo de como integrar as novas configurações ao botão de Configurações, baixe o Exemplo de configurações de aplicativo.

Usando C#/VB/C++ e XAML? Veja os tópicos na seção Adicionando configurações do aplicativo (aplicativos da Windows Store em C#/VB/C++ e XAML).

Nesta seção

Tópico	Descrição
Início rápido: Usando a Biblioteca do Windows para JavaScript	Este guia de início rápido lhe guia pela implementação do contrato de Configurações usando HTML e a classe SettingsFlyout para a Biblioteca do Windows para JavaScript.
Início rápido: usando o Tempo de Execução do Windows	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.
Como confirmar configurações instantaneamente	Nos aplicativos da Windows Store, todas as configurações são aplicadas assim que o usuário altera seus valores. Esse modelo é importante porque o usuário pode guiá-lo pela confirmação instantânea de configurações usando o submenu Configurações do WinJS e os dados de aplicativo locais.