Adicionando caixas de diálogo de mensagem (HTML)

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

Uma caixa de diálogo de mensagem é uma superfície explicitamente ignorada disponível para os desenvolvedores de aplicativo que requer uma resposta imediata do usuário. Essas caixas de diálogo esmaecem a tela atrás delas e bloqueiam os eventos de toque na tela do aplicativo até que o usuário responda.

Uma caixa de diálogo de mensagem usa texto e botões, especificados pelo desenvolvedor do aplicativo, para fazer uma das seguintes opções:

• Transmitir informação urgente.
• Apresentar uma mensagem de erro.
• Faça uma pergunta que o usuário deve responder para eliminar um bloqueio do fluxo principal de um aplicativo.

Uma caixa de diálogo de mensagem pode ser em resposta à ação do usuário, ou solicitada pelo aplicativo com base no estado do aplicativo.

As caixas de diálogo de mensagem devem ser usadas de forma refletida e parcimoniosa e somente se a mensagem a ser transmitida for essencial naquele momento para o aplicativo. As caixas de diálogo devem ser usadas somente por aplicativos da Windows Store, não por aplicativos Clássicos do Windows.

A imagem a seguir mostra as três partes de uma caixa de diálogo de mensagem:

• Título (opcional) — usado como instrução principal.
• Conteúdo (obrigatório) — usado como texto descritivo.
• Botões e cadeias de botões (obrigatórios) — para indicar a ação explícita do usuário.

As caixas de diálogo de mensagem são exibidas de borda a borda na tela do aplicativo. Aqui está um exemplo de erro de conectividade. A caixa de diálogo usa apenas o texto do conteúdo para transmitir a mensagem.

Veja a seguir um exemplo de erro de caminho de rede emitido pelo seletor de arquivos. A caixa de diálogo usa apenas a cadeia de caracteres do bloco e o texto do conteúdo para transmitir a mensagem.

Observação  O objetivo da caixa de diálogo não é substituir todos os usos de caixas de diálogo de tarefa e caixas de diálogo de mensagem em aplicativos Clássicos anteriores do Windows. A API MessageDialog foi projetada para ser usada somente por aplicativos da Windows Store. Para obter orientação em cenários em que as caixas de diálogo de mensagem devem ser usadas, veja Uso apropriado de caixas de diálogo de mensagem.

Nesta seção