Confirm Fungsi

Terpakai kepada: Apl kanvas Apl dipacu model

Gunakan fungsi ini untuk memaparkan kotak dialog pengesahan kepada pengguna.

Perihalan

Fungsi ini Confirm memaparkan kotak dialog di atas skrin semasa dengan dua butang: butang sahkan dan butang batal . Dalam apl dipacu model, butang ini lalai kepada versi setempat "OK" dan "Batal" masing-masing. Confirm juga tersedia dalam apl kanvas untuk menunjukkan dialog pengesahan mudah dan mengembalikan hasil Boolean.

Pengguna mesti memilih salah satu butang sebelum dialog ditolak. Selain memilih butang Batal, dialog boleh ditolak melalui gerak isyarat khusus platform (seperti kekunci Esc atau mengklik di luar dialog). Dalam apl kanvas, laluan pemecatan ini dianggap sebagai tiada tindakan (iaitu, ia mengembalikan blank).

Nota

Dalam apl kanvas, fungsi menggunakan Confirm dialog Fasih. Pastikan kawalan moden didayakan; Jika tidak, dialog penyemak imbas asli muncul.

Syntax

Confirm( Message [, OptionsRecord ] )
  • Mesej - Diperlukan. Message untuk dipaparkan kepada pengguna.
  • OptionsRecord - Pilihan. Sediakan tetapan pilihan untuk kotak dialog. Lihat di bawah untuk pilihan yang tersedia.

Opsyen

Gunakan parameter OptionsRecord untuk menyesuaikan dialog pengesahan:

Pilihan Perihalan
Butang Pengesahan Teks untuk dipaparkan pada butang sahkan, menggantikan teks "OK" atau "Confirm" setempat lalai.
Butang Batal Teks untuk dipaparkan pada butang batal, menggantikan teks "Batal" setempat lalai.
Tajuk Teks yang akan dipaparkan sebagai tajuk dialog. Dipaparkan dalam fon yang lebih besar dan lebih berani daripada mesej. Ia mungkin dipotong jika sangat panjang.
Sarikata Teks untuk dipaparkan sebagai sari kata dialog. Dipaparkan antara tajuk dan mesej. Ia mungkin dipotong jika sangat panjang.

Tingkah laku lalai

Label butang: Jika anda tidak memberikan label butang tersuai, Confirm gunakan teks butang lalai yang disetempatkan:

  • Dalam apl kanvas (pratonton), lalai ialah "Confirm" dan "Batal" (disetempatkan).
  • Dalam apl dipacu model, lalai ialah "OK" dan "Batal" (disetempatkan).

Nilai pulangan:Confirm Kembali true jika pengguna memilih butang sahkan, dan false sebaliknya.

Contoh

Aplikasi berpandukan model

Pengesahan mudah sebelum mengalih keluar rekod

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

Memaparkan dialog pengesahan dengan butang lalai. Jika pengguna memilih butang sahkan, rekod akan dialih keluar.

Pengesahan dengan tajuk tersuai

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

Menambah tajuk pada dialog pengesahan sebelum mengalih keluar rekod.

Label butang tersuai untuk keutamaan pengguna

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

Menggunakan label butang tersuai untuk menangkap keutamaan mudah. Hasilnya disimpan dalam pembolehubah FavColorglobal .

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

Memaparkan mesej modal yang mesti diakui oleh pengguna sebelum meneruskan. Nilai pulangan tidak ditandakan.

Aplikasi kanvas

Confirm sebelum memadam

Gunakan Confirm untuk mengelakkan pemadaman rekod secara tidak sengaja:

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

Memaparkan dialog pengesahan dengan label tajuk, sari kata dan butang tersuai. Rekod hanya dipadamkan jika pengguna memilih Padam.

Confirm Sebelum menyimpan borang

Gunakan Confirm untuk mengesahkan niat pengguna sebelum menyerahkan data:

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

Memaparkan dialog pengesahan sebelum menyerahkan borang. Borang hanya diserahkan jika pengguna mengesahkan.

Simpan hasil dalam pembolehubah untuk berbilang tindakan

Simpan hasil pengesahan untuk digunakan dalam berbilang operasi hiliran:

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

Hasil Boolean disimpan dalam varConfirmed dan boleh dirujuk beberapa kali untuk logik bersyarat.

Penyesuaian penuh dengan semua pilihan

Pamerkan semua pilihan penyesuaian yang tersedia:

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

Memaparkan dialog tersuai sepenuhnya dengan tajuk, sari kata, mesej dan label butang tersuai.

Soalan Lazim (FAQ)

Bolehkah saya menyembunyikan butang Batal?

Tidak. Reka bentuk semasa sentiasa menunjukkan kedua-dua Confirm butang dan Batal. Pengguna mesti mempunyai keupayaan untuk menolak atau membatalkan dialog.

Bolehkah saya menambah butang ketiga atau lebih daripada dua pilihan?

Tidak. Confirm menyokong betul-betul dua pilihan: tindakan sahkan dan tindakan batal. Untuk senario yang memerlukan berbilang pilihan, pertimbangkan untuk menggunakan corak UI yang berbeza seperti skrin tersuai atau kawalan juntai bawah.

Adakah Confirm menyekat operasi lain?

Ya. Confirm dipaparkan sebagai dialog modal yang mesti ditolak oleh pengguna sebelum mereka boleh berinteraksi dengan bahagian apl yang lain.

Lihat juga

Beritahu - Memaparkan mesej sepanduk bukan modal di bahagian atas skrin yang tidak memerlukan pemecatan pengguna.

  • Last updated on