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
- Aggiunta di finestre di dialogo di messaggio
- Linee guida ed elenco di controllo per le finestre di dialogo di messaggio
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.
1. Crea i contenuti della finestra di dialogo.
// 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;
3. Visualizza la finestra di dialogo.
// 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.
}
Riepilogo
In questa guida introduttiva sono state illustrate istruzioni utili per la progettazione e l'implementazione delle finestre di dialogo di messaggio.