Funzione Confirm

Si applica a: App basate su modello

Visualizza una finestra di dialogo di conferma per l'utente.

Description

Nota

Al momento, la funzione Conferma è disponibile solo durante la scrittura di comandi Power Fx per le app basate su modello.

La funzione Conferma visualizza una finestra di dialogo nella parte superiore della schermata corrente. Sono forniti due pulsanti: un pulsante di conferma e un pulsante di annullamento, che per impostazione predefinita sono rispettivamente le versioni localizzate di "OK" e "Annulla". L'utente deve confermare o annullare prima della chiusura della finestra di dialogo. Oltre al pulsante della finestra di dialogo, Annulla può essere selezionato anche con il tasto Esc o altri gesti specifici della piattaforma.

Il parametro Messaggio viene visualizzato nel corpo della finestra di dialogo. Se il messaggio è lungo, verrà troncato o potrebbe essere fornita una barra di scorrimento.

Usa il parametro OptionsRecord per specificare le opzioni per la finestra di dialogo. Non tutte le opzioni sono disponibili in tutte le piattaforme e vengono gestite sulla base del miglior sforzo. Queste opzioni non sono supportate nelle app canvas.

Campo opzione	Description
ConfermaPulsante	Il testo da visualizzare nel pulsante di conferma che sostituisce il testo "OK" localizzato predefinito.
AnnullaPulsante	Il testo da visualizzare nel pulsante annulla che sostituisce il testo "Annulla" localizzato predefinito.
Titolo	Il testo da visualizzare come titolo della finestra di dialogo. Per visualizzare questo testo è possibile utilizzare un carattere più grande e più in grassetto rispetto al carattere del messaggio. Il testo verrà troncato se troppo lungo.
Sottotitolo	Il testo da visualizzare come sottotitolo della finestra di dialogo. Per visualizzare questo testo è possibile utilizzare un carattere più grande e più in grassetto rispetto al carattere del messaggio. Il testo verrà troncato se troppo lungo.

Conferma restituisce true se è stato selezionato il pulsante conferma , false in caso contrario.

Usa la funzione Notifica per visualizzare un banner nella parte superiore dell'app che non deve essere eliminato.

Sintassi

Conferma( Messaggio [, OpzioniRegistrazione ] )

• Messaggio - Obbligatorio. Messaggio da visualizzare all'utente.
• OptionsRecord - Facoltativo. Fornisce le impostazioni delle opzioni per la finestra di dialogo. Non tutte le opzioni sono disponibili in tutte le piattaforme e vengono gestite sulla base del "miglior sforzo".

Esempi

If( Confirm( "Are you sure?" ), Remove( ThisItem ) )

Finestra di dialogo di conferma semplice, che chiede all'utente di confermare l'eliminazione di un record prima che venga rimosso. A meno che l'utente non prema il pulsante "OK", il record non verrà eliminato.

If( Confirm( "Are you sure?", {Title: "Delete Confirmation"} ), Remove( ThisItem ) )

Stessa finestra di dialogo dell'ultimo esempio, ma aggiunge il testo del titolo.

Set( FavColor, 
     If( Confirm( "What is your favorite color?", 
                  { ConfirmButton: "Red", CancelButton: "Green" } 
         ), 
         "Red", 
         "Green" 
     ) 
)

Chiede all'utente il suo colore preferito, acquisendo il risultato in una variabile globale. Il risultato che verrà inserito in FavColor sarà la stringa di testo "Rosso" o "Verde". Come scelta di conferma, "Rosso" è il valore predefinito. Funziona solo su piattaforme che supportano le opzioni ConfirmButton e CancelButton.

Confirm( "There was a problem, please review your order." )

Visualizza un messaggio in modo molto simile alla funzione Notifica, ma è modale e richiede all'utente di selezionare un pulsante per procedere. Da utilizzare in situazioni in cui è importante che l'utente confermi la lettura del messaggio prima di procedere. In questa situazione, il pulsante selezionato non è importante e il risultato non viene verificato.