fungsi Confirm

Berlaku untuk: Aplikasi berdasarkan model

Tampilkan kotak dialog konfirmasi kepada pengguna.

Description

Catatan

Saat ini, Confirm fungsi hanya tersedia saat menulis perintah Power Fx untuk aplikasi berbasis model.

Fungsi Confirm menampilkan kotak dialog di atas layar saat ini. Dua tombol disediakan: tombol konfirmasi dan tombol batal, yang masing-masing default ke versi lokal "OK" dan "Batal". Pengguna harus mengkonfirmasi atau membatalkan sebelum kotak dialog ditutup dan fungsi kembali. Selain tombol dialog, batal juga dapat dipilih dengan tombol Esc atau gerakan lain yang spesifik platform.

Parameter Pesan ditampilkan di isi kotak dialog. Jika pesan panjang, pesan dapat dipotong, atau bilah gulir dapat disediakan.

Gunakan parameter OptionsRecord untuk menentukan opsi untuk kotak dialog. Tidak semua pilihan tersedia di setiap platform dan ditangani dengan upaya terbaik. Opsi ini tidak didukung di aplikasi kanvas.

Bidang Pilihan	Description
Tombol Konfirmasi	Teks yang akan ditampilkan pada tombol konfirmasi , menggantikan teks "OK" default yang dilokalkan.
Tombol Batal	Teks yang akan ditampilkan pada tombol batal, menggantikan teks "Batal" default yang dilokalkan.
Titel	Teks yang akan ditampilkan sebagai judul kotak dialog. Font yang lebih besar dan tebal daripada font pesan dapat digunakan untuk menampilkan teks ini. Teks dipotong jika panjang.
Subjudul	Teks yang akan ditampilkan sebagai subjudul kotak dialog. Font yang lebih besar dan tebal daripada font pesan dapat digunakan untuk menampilkan teks ini. Teks dipotong jika panjang.

Confirm mengembalikan true jika tombol konfirmasi dipilih, jika tidak salah .

Gunakan fungsi Notify untuk menampilkan spanduk pesan di bagian atas aplikasi yang tidak perlu ditutup.

Sintaks

Confirm( Pesan [, OptionsRecord ] )

• Pesan - Wajib. Pesan yang ditampilkan kepada pengguna.
• OptionsRecord - Opsional. Berikan pengaturan opsi untuk kotak dialog. Tidak semua pilihan tersedia di setiap platform dan ditangani dengan "upaya terbaik".

Contoh

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

Dialog konfirmasi sederhana, meminta pengguna untuk mengonfirmasi penghapusan rekaman sebelum dihapus. Kecuali pengguna menekan tombol "OK", catatan tidak akan dihapus.

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

Dialog yang sama seperti contoh terakhir, tetapi menambahkan teks Judul.

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

Menanyakan pada pengguna tentang warna favorit mereka, menangkap hasilnya ke variabel global. Hasil yang ditempatkan di FavColor akan menjadi string teks "Merah" atau "Hijau". Sebagai pilihan konfirmasi , "Merah" adalah default. Ini hanya berfungsi pada platform yang mendukung opsi ConfirmButton dan CancelButton .

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

Menampilkan pesan seperti fungsi Notify , tetapi bersifat modal dan mengharuskan pengguna untuk memilih tombol untuk melanjutkan. Gunakan jika penting bagi pengguna untuk mengakui pesan sebelum melanjutkan. Dalam situasi ini, tombol mana yang dipilih tidak penting dan hasilnya tidak diperiksa.