Confirm funcționa

Se aplică la: Aplicații pânză bazate pe modele de aplicații

Utilizați această funcție pentru a afișa o casetă de dialog de confirmare pentru utilizator.

Descriere

Funcția Confirm afișează o casetă de dialog în partea de sus a ecranului curent cu două butoane: un buton confirmare și un buton anulare . În aplicațiile bazate pe modele, aceste butoane sunt setate implicit la versiunile localizate de "OK" și respectiv "Anulare". Confirm este, de asemenea, disponibil în aplicațiile pânză pentru a afișa un dialog de confirmare simplu și a returna un rezultat Boolean.

Utilizatorul trebuie să aleagă unul dintre butoane înainte ca caseta de dialog să fie respinsă. Pe lângă selectarea butonului Anulare, caseta de dialog poate fi respinsă prin gesturi specifice platformei (cum ar fi tasta Esc sau un clic în afara casetei de dialog). În aplicațiile pânză, această cale de îndepărtare este tratată ca nicio acțiune (adică returnează blank).

Notă

În aplicațiile de pânză, funcția Confirm utilizează caseta de dialog Fluent. Asigurați-vă că sunt activate controalele moderne; în caz contrar, apare caseta de dialog a browserului nativ.

Sintaxă

Confirm( Message [, OptionsRecord ] )
  • Mesaj - Obligatoriu. Mesaj de afișat pentru utilizator.
  • OptionsRecord - Opțional. Furnizați setările opțiunilor pentru caseta de dialog. Vedeți mai jos opțiunile disponibile.

Opțiuni

Utilizați parametrul OptionsRecord pentru a particulariza caseta de dialog de confirmare:

Opțiune Descriere
ConfirmButton Textul de afișat pe butonul confirmare, înlocuind textul localizat implicit "OK" sau "Confirm".
Butonul Anulare Textul de afișat pe butonul Anulare, înlocuind textul localizat implicit "Anulare".
Titlu Textul de afișat ca titlu de dialog. Afișat într-un font mai aldin și mai mare decât mesajul. Ar putea fi trunchiată dacă este foarte lungă.
Subtitlu Textul de afișat ca subtitlu de dialog. Afișat între titlu și mesaj. Ar putea fi trunchiată dacă este foarte lungă.

Comportament implicit

Etichete buton: Dacă nu furnizați etichete de butoane particularizate, Confirm utilizează textul butonului implicit localizat:

  • În aplicațiile pânză (previzualizare), valorile implicite sunt "Confirm" și "Anulare" (localizate).
  • În aplicațiile bazate pe modele, valorile implicite sunt "OK" și "Anulare" (localizate).

Valoare returnată:Confirm returnează true dacă utilizatorul selectează butonul confirmare și false în caz contrar.

Exemple

Aplicațiile proiectate pe bază de model

Confirmare simplă înainte de a elimina o înregistrare

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

Afișează o casetă de dialog de confirmare cu butoanele implicite. Dacă utilizatorul selectează butonul confirmare, înregistrarea este eliminată.

Confirmare cu titlu particularizat

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

Adaugă un titlu la caseta de dialog de confirmare înainte de a elimina o înregistrare.

Etichete buton particularizate pentru preferința utilizatorului

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

Utilizează etichete de butoane particularizate pentru a captura o preferință simplă. Rezultatul este stocat în variabila FavColorglobală .

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

Afișează un mesaj modal pe care utilizatorul trebuie să-l recunoască înainte de a continua. Valoarea returnată nu este bifată.

Aplicațiile create pe planșă

Confirm înainte de a șterge

Se utilizează Confirm pentru a împiedica ștergerea accidentală a înregistrărilor:

// 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)
)

Afișează o casetă de dialog de confirmare cu etichetele de buton titlu, subtitrare și particularizate. Înregistrarea este ștearsă doar dacă utilizatorul selectează Ștergere.

Confirm înainte de a salva un formular

Se utilizează Confirm pentru a valida intenția utilizatorului înainte de a trimite date:

// 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)
)

Afișează o casetă de dialog de confirmare înainte de a remite formularul. Formularul este remis doar dacă utilizatorul confirmă.

Stocarea rezultatului într-o variabilă pentru mai multe acțiuni

Stocați rezultatul de confirmare de utilizat în mai multe operațiuni în aval:

// 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)
)

Rezultatul Boolean este stocat în varConfirmed și poate fi menționat de mai multe ori pentru logica condițională.

Particularizare completă cu toate opțiunile

Galerie toate opțiunile de particularizare disponibile:

// 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)
)

Afișează o casetă de dialog particularizată complet cu titlu, subtitrare, mesaj și etichete de butoane particularizate.

Întrebări frecvente

Pot ascunde butonul Anulare?

Nu. Proiectarea curentă afișează întotdeauna atât butoanele Confirm , cât și Butoanele Anulare. Utilizatorii trebuie să aibă capacitatea de a respinge sau a anula caseta de dialog.

Pot adăuga un al treilea buton sau mai mult de două opțiuni?

Nu. Confirm acceptă exact două opțiuni: o acțiune de confirmare și o acțiune de anulare. Pentru scenariile care necesită mai multe opțiuni, luați în considerare utilizarea unui alt model de interfață utilizator, cum ar fi un ecran particularizat sau un control vertical.

Blochează Confirm alte operațiuni?

Da. Confirm se afișează ca o casetă de dialog modală pe care utilizatorul trebuie să o dezactiveze înainte de a putea interacționa cu alte părți ale aplicației.

Vedeți și

Notificare - afișează un mesaj banner non-modal în partea de sus a ecranului care nu necesită dezactivarea utilizatorului.

  • Last updated on