Funzione Confirm

Si applica a: App basate su modello, app Canvas

Utilizzare questa funzione per visualizzare una finestra di dialogo di conferma all'utente.

Description

La Confirm funzione visualizza una finestra di dialogo nella parte superiore della schermata corrente con due pulsanti: un pulsante di conferma e un pulsante annulla . Nelle app basate su modello, questi pulsanti sono rispettivamente versioni localizzate di "OK" e "Annulla". Confirm è disponibile anche nelle app canvas per visualizzare una finestra di dialogo di conferma semplice e restituire un risultato booleano.

L'utente deve scegliere uno dei pulsanti prima che la finestra di dialogo venga chiusa. Oltre a selezionare il pulsante Annulla, la finestra di dialogo può essere chiusa tramite movimenti specifici della piattaforma , ad esempio il tasto ESC o facendo clic all'esterno della finestra di dialogo. Nelle app canvas questo percorso di chiusura viene considerato come nessuna azione , ovvero restituisce blank.

Sintassi

Confirm( Message [, OptionsRecord ] )

• Messaggio - Obbligatorio. Messaggio da visualizzare all'utente.
• OptionsRecord - Facoltativo. Fornisce le impostazioni delle opzioni per la finestra di dialogo. Vedere di seguito per le opzioni disponibili.

Options

Usare il parametro OptionsRecord per personalizzare la finestra di dialogo di conferma:

Comportamento predefinito

Etichette dei pulsanti: Se non si specificano etichette di pulsante personalizzate, Confirm usa il testo del pulsante predefinito localizzato:

• Nelle app canvas (anteprima), le impostazioni predefinite sono "Confirm" e "Annulla" (localizzate).
• Nelle app basate su modello, le impostazioni predefinite sono "OK" e "Annulla" (localizzate).

Valore restituito:Confirm restituisce true se l'utente seleziona il pulsante conferma e false in caso contrario.

Esempi

App basate su modello

Conferma semplice prima della rimozione di un record

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

Visualizza una finestra di dialogo di conferma con pulsanti predefiniti. Se l'utente seleziona il pulsante di conferma, il record viene rimosso.

Conferma con titolo personalizzato

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

Aggiunge un titolo alla finestra di dialogo di conferma prima di rimuovere un record.

Etichette dei pulsanti personalizzate per le preferenze utente

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

Usa etichette di pulsanti personalizzate per acquisire una preferenza semplice. Il risultato viene archiviato nella variabile FavColorglobale .

Messaggio modale senza controllare il valore restituito

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

Visualizza un messaggio modale che l'utente deve confermare prima di continuare. Il valore restituito non è selezionato.

App canvas

Confirm prima dell'eliminazione

Usare Confirm per impedire l'eliminazione accidentale dei record:

// Button.OnSelect
If(
    Confirm(
        "Are you sure you want to delete this record?",
        {
            Title: "Delete confirmation",
            Subtitle: "This action can't be undone.",
            ConfirmButton: "Delete",
            CancelButton: "Cancel"
        }
    ),
    Remove(YourDataSource, Gallery1.Selected);
    Notify("Record deleted.", NotificationType.Success)
)

Visualizza una finestra di dialogo di conferma con il titolo, il sottotitolo e le etichette dei pulsanti personalizzati. Il record viene eliminato solo se l'utente seleziona Elimina.

Confirm prima di salvare un modulo

Usare Confirm per convalidare la finalità dell'utente prima di inviare i dati:

// Save button.OnSelect
If(
    Confirm(
        "Do you want to save these changes?",
        { Title: "Save changes" }
    ),
    SubmitForm(EditForm1);
    ResetForm(EditForm1);
    Notify("Changes saved successfully.", NotificationType.Success)
)

Visualizza una finestra di dialogo di conferma prima di inviare il modulo. Il modulo viene inviato solo se l'utente conferma.

Archiviare il risultato in una variabile per più azioni

Archiviare il risultato della conferma da usare in più operazioni downstream:

// Button.OnSelect
Set(
    varConfirmed,
    Confirm("Do you want to proceed with this operation?")
);

If(
    varConfirmed,
    Notify("Processing your request...", NotificationType.Information);
    /* Additional operations */,
    Notify("Operation canceled.", NotificationType.Warning)
)

Il risultato booleano viene archiviato in varConfirmed e può essere fatto riferimento più volte per la logica condizionale.

Personalizzazione completa con tutte le opzioni

Mostrare tutte le opzioni di personalizzazione disponibili:

// Button.OnSelect
If(
    Confirm(
        "This is the main message that describes what the user needs to confirm.",
        {
            Title: "Action Required 🔔",
            Subtitle: "Please choose one of the options below.",
            ConfirmButton: "Yes, proceed",
            CancelButton: "No, cancel"
        }
    ),
    Notify("User confirmed!", NotificationType.Success),
    Notify("User canceled.", NotificationType.Warning)
)

Visualizza una finestra di dialogo completamente personalizzata con le etichette del titolo, del sottotitolo, del messaggio e dei pulsanti personalizzati.

FAQs

È possibile nascondere il pulsante Annulla?

No La progettazione corrente mostra sempre i Confirm pulsanti e Annulla. Gli utenti devono avere la possibilità di ignorare o annullare la finestra di dialogo.

È possibile aggiungere un terzo pulsante o più di due opzioni?

No Confirm supporta esattamente due opzioni: un'azione di conferma e un'azione di annullamento. Per gli scenari che richiedono più scelte, è consigliabile usare un modello di interfaccia utente diverso, ad esempio uno schermo personalizzato o un controllo a discesa.

Blocca Confirm altre operazioni?

Sì. Confirm visualizza come finestra di dialogo modale che l'utente deve ignorare prima di poter interagire con altre parti dell'app.

Vedere anche

Notifica : visualizza un messaggio banner non modale nella parte superiore della schermata che non richiede la chiusura dell'utente.