Controllo Dialog (sperimentale)

[Questo articolo fa parte della documentazione non definitiva, pertanto è soggetto a modifiche.]

Un comando utilizzato per raggruppare il contenuto.

Importante

• Questa è una funzionalità sperimentale.
• Le funzionalità sperimentali non sono destinate ad essere utilizzate per la produzione e sono soggette a restrizioni. Queste funzionalità sono disponibili prima di una versione ufficiale di modo che i clienti possano ottenere un accesso prioritario e fornire dei commenti.

Descrizione

Una finestra di dialogo (Finestra) è una finestra popup temporanea che prende lo stato attivo dalla pagina o dall'app e richiede che le persone interagiscano con essa. Viene utilizzato principalmente per confermare azioni, come eliminare un file o chiedere alle persone di fare una scelta.

Questo componente canvas imita lo stile e il comportamento del comando Finestra di dialogo dell'interfaccia utente Fluent. Vedi la documentazione per le procedure consigliate.

Visualizza il componente nel repository GitHub del Kit per gli autori

Proprietà

Proprietà chiave

Proprietà	Descrizione
Buttons	Un set di dati che definisce i pulsanti (vedi le proprietà di seguito)
Title	Testo visualizzato nella sezione del titolo
OverlayColor	Colore visualizzato nell'area di sovrimpressione
DialogWidth	La larghezza della finestra di dialogo (da non confondere con la larghezza del comando, che dovrebbe estendersi alla larghezza dell'app)
DialogHeight	L'altezza della finestra di dialogo (da non confondere con l'altezza del comando, che dovrebbe estendersi all'altezza dell'app).
SubTitle	Testo visualizzato sotto il titolo

Proprietà Buttons

Proprietà	Descrizione
Label	L'etichetta visualizzata sul pulsante.
ButtonType	Enumerazione che determina lo stile del pulsante. Scegli tra Standard e Primary.

Table(
    {
        Label: "Cancel", 
        ButtonType:'Microsoft.CoreControls.Button.ButtonType'.Standard 
    },{
        Label: "Ok", 
        ButtonType:'Microsoft.CoreControls.Button.ButtonType'.Primary
    }
)

Proprietà di stile

Proprietà	Descrizione
Theme	Oggetto del tema. Vedi la creazione di temi per istruzioni su come eseguire la configurazione.

Per la formattazione, vedi le istruzioni nella sezione Contenuto del pannello Formato di Pannello.

Proprietà dell'evento

Proprietà	Descrizione
OnCloseSelect	Espressione di azione che viene eseguita quando viene selezionato il pulsante di chiusura.
OnButtonSelect	Espressione di azione che viene eseguita quando viene selezionato uno dei pulsanti di azione.

Comportamento

Configura la visibilità della finestra di dialogo

Rendi il comando Dialog visibile (o la superficie su cui si trova) quando una variabile di tipo booleano (true/false) cambia in true e assegna quella variabile alla proprietà di visibilità della finestra di dialogo. Una volta visualizzata la finestra di dialogo, è possibile nascondere la finestra di dialogo aggiornando la variabile sulla proprietà di ripristino, che viene attivata quando si fa clic sull'icona di chiusura.

Formula Power Fx per aprire la finestra di dialogo, in una formula di azione su un altro componente da qualche parte nell'app (ad esempio, la proprietà OnSelect di un pulsante):

UpdateContext({ showHideDialog: true })

Formula Power Fx per chiudere la finestra di dialogo, nella proprietà OnCloseSelect della finestra di dialogo:

UpdateContext({ showHideDialog: false })

Assegna la variabile alla proprietà Visible della finestra di dialogo:

showHideDialog

Configurare le azioni del pulsante

Nella proprietà OnButtonSelect della finestra di dialogo, fornisci azioni in una condizione If() o Switch() basata sul valore di testo Self.SelectedButton.Label per definire l'azione. A seconda dell'azione, potrebbe essere opportuno chiudere la finestra di dialogo anche dopo che l'azione è stata completata.

    If( Self.SelectedButton.Label = "Send", 
        Notify("Email Sent")
    );
    UpdateContext({ showHideDialog: false })

Limiti

Questo componente canvas può essere usato solo nelle app canvas e nelle pagine personalizzate.