Guia de início rápido: criando uma caixa de diálogo de mensagem (HTML)

Artigo
03/04/2016

[ 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 guia de início rápido apresenta diretrizes para a criação e implementação de caixas de diálogo de mensagem. Conforme descrito em Adicionando caixas de diálogo de mensagem, as caixas de diálogo de mensagem aparecem de uma ponta à outra no aplicativo e são redimensionadas horizontalmente com base em seu conteúdo. Você pode adicionar um título, uma mensagem e até três botões à caixa de diálogo.

Pré-requisitos

Etapas

O código de exemplo mostra uma caixa de diálogo de mensagem que notifica o usuário quando não é encontrada uma conexão com a Internet e pede ao usuário uma resposta. A maior parte do código deste guia de início rápido está em Amostra de caixa de diálogo de mensagem.

1. Crie o conteúdo da caixa de diálogo.


        // Create the message dialog and set its content
        var msg = new Windows.UI.Popups.MessageDialog(
            "No internet connection has been found.");

2. Adicione botões.

        // Add commands and set their command handlers
        msg.commands.append(new Windows.UI.Popups.UICommand(
            "Try again", 
            commandInvokedHandler));
        msg.commands.append(
            new Windows.UI.Popups.UICommand("Close", commandInvokedHandler));

        // Set the command that will be invoked by default
        msg.defaultCommandIndex = 0;

        // Set the command to be invoked when escape is pressed
        msg.cancelCommandIndex = 1;

3. Exiba a caixa de diálogo.

        // Show the message dialog
        msg.showAsync();

4. Se desejado, use várias interfaces modais.

Às vezes, você pode querer iniciar outra interface do usuário modal a partir de uma caixa de diálogo, como abrir o seletor de arquivos em uma caixa de diálogo de mensagem. O Windows não deixa você iniciar a interface do usuário modal extra a partir do manipulador de comandos da caixa de diálogo original.

Você deve iniciar a interface do usuário secundária de dentro do manipulador completo da operação assíncrona. O manipulador completo é executado depois que a caixa de diálogo é destruída e recebe o resultado da operação assíncrona, assim você ainda pode identificar em qual comando o usuário clicou na interface do usuário original.


        var result = await msg.ShowAsync();

        if (result.Label == "Buy")
        {
            await this.YourCustomFLow(result);
        }
 
        private async Task YourCustomFlow(IUICommand command)
        {
            // Your code here.
        }

Resumo

Este guia de início rápido apresentou as diretrizes para a criação e implementação de caixas de diálogo de mensagem.

Tópicos relacionados

MessageDialog

Amostra de caixa de diálogo de mensagem

Partilhar via