Guida introduttiva: Progettazione di una finestra di messaggio (HTML)

[ Questo articolo è rivolto agli sviluppatori per Windows 8.x e Windows Phone 8.x che realizzano app di Windows Runtime. Gli sviluppatori che usano Windows 10 possono vedere Documentazione aggiornata ]

Questa guida introduttiva contiene istruzioni utili per la progettazione e l'implementazione delle finestre di dialogo di messaggio. Come descritto in Aggiunta di finestre di messaggio, le finestre di dialogo dei messaggi vengono visualizzati per l'intera larghezza di un'app e vengono ridimensionate orizzontalmente a seconda del contenuto. Nella finestra di dialogo puoi aggiungere un riquadro, un messaggio e fino a tre pulsanti.

Prerequisiti

Passaggi

Nel codice di esempio viene illustrata una finestra di messaggio indicante che non è possibile trovare una connessione Internet e che richiede l'intervento dell'utente. La maggior parte del codice in questa guida introduttiva è disponibile nell'esempio di finestra di dialogo di messaggio.


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

2. Aggiungi i pulsanti.

        // 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;
        // Show the message dialog
        msg.showAsync();

4. Se lo desideri, gestisci più interfacce utente modali.

A volte può essere consigliabile avviare un'altra interfaccia utente modale da una finestra di dialogo, come avviene quando si apre la finestra di selezione file dalla finestra di dialogo di un messaggio. Windows non consente di avviare altre interfacce utente dal gestore dei comandi della finestra di dialogo originale.

È invece necessario avviare l'interfaccia utente secondaria dal gestore completato dell'operazione asincrona. Il gestore completato viene eseguito dopo che la finestra di dialogo viene rimossa e riceve il risultato dell'operazione asincrona, pertanto risulta comunque possibile indicare il comando su cui l'utente ha fatto clic nell'interfaccia utente originale.


        var result = await msg.ShowAsync();

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

In questa guida introduttiva sono state illustrate istruzioni utili per la progettazione e l'implementazione delle finestre di dialogo di messaggio.

Argomenti correlati

MessageDialog

Esempio di finestra di dialogo di messaggio