Condividi tramite

Controllo Dialog (sperimentale)

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

Un comando utilizzato per raggruppare il contenuto.

Controllo del dialogo.

Importante

  • Questa è una funzionalità sperimentale.
  • Le funzionalità di anteprima non sono progettate per l'uso in produzione e possono avere funzionalità limitate. 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 (controllo Dialog) è una finestra popup temporanea che ottiene lo stato attivo dalla pagina o dall'app e con cui le persone devono interagire. 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 relativa alle procedure consigliate.

Visualizza il componente nel repository GitHub del Kit per gli autori

Proprietà

Proprietà chiave

Proprietà Descrizione
Buttons Set di dati che definisce i pulsanti (altre informazioni in Proprietà dei pulsanti).
Title Testo visualizzato nella sezione del titolo.
OverlayColor Colore visualizzato nell'area di sovrapposizione.
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à dei pulsanti

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. Altre informazioni sui temi.

Scopri di più su come formattare nella sezione contenuto del 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 controllo Dialog visibile (o la superficie su cui si trova) quando una variabile booleana (true/false) cambia in true. Assegna quella variabile alla proprietà di visibilità della finestra di dialogo. Per nascondere la finestra di dialogo dopo la sua visualizzazione, aggiorna la variabile sulla proprietà di ripristino, che viene attivata quando si fa clic sull'icona di chiusura.

La seguente mostra la formula di Power Fx per aprire il dialogo in una formula d'azione su un altro componente dell'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.

  • Last updated on