ฟังก์ชัน Confirm

ใช้กับ: แอปแบบจำลอง

แแสดงกล่องโต้ตอบการยืนยันต่อผู้ใช้

Description

หมายเหตุ

ในขณะนี้ ฟังก์ชัน Confirm ใช้งานได้เฉพาะเมื่อมีการเขียนคำสั่ง Power Fx สำหรับแอปแบบจำลองเท่านั้น

ฟังก์ชัน Confirm จะแสดงกล่องโต้ตอบที่ด้านบนของหน้าจอปัจจุบัน มีปุ่มให้เลือกสองปุ่ม: ปุ่ม ยืนยัน และปุ่ม ยกเลิก ซึ่งมีค่าเริ่มต้นเป็นรุ่นที่แปลของ "ตกลง" และ "ยกเลิก" ตามลำดับ ผู้ใช้ต้องยืนยันหรือยกเลิกก่อนที่กล่องโต้ตอบจะถูกปิดและฟังก์ชันจะกลับคืนมา นอกจากปุ่มกล่องโต้ตอบแล้ว คุณยังสามารถเลือก ยกเลิก ได้ด้วยปุ่ม Esc หรือท่าทางสัมผัสอื่นๆ ที่เจาะจงแพลตฟอร์ม

พารามิเตอร์ ข้อความ จะแสดงในเนื้อหาของกล่องโต้ตอบ หากข้อความยาว ข้อความนั้นจะถูกตัดให้สั้นลงหรืออาจมีแถบเลื่อนที่จัดเตรียมไว้ให้

ใช้พารามิเตอร์ OptionsRecord เพื่อระบุตัวเลือกสำหรับกล่องโต้ตอบ ตัวเลือกบางตัวอาจไม่สามารถใช้ได้ในทุกแพลตฟอร์มและได้รับการจัดการบนพื้นฐานความพยายามอย่างดีที่สุด ตัวเลือกเหล่านี้ไม่รองรับในแอปพื้นที่ทำงาน

ฟิลด์ตัวเลือก	รายละเอียด
ConfirmButton	ข้อความที่จะแสดงบนปุ่ม ยืนยัน แทนที่ข้อความ "ตกลง" ที่แปลเป็นค่าเริ่มต้น
CancelButton	ข้อความที่จะแสดงบนปุ่ม ยกเลิก แทนที่ข้อความ "ยกเลิก" ที่แปลเป็นค่าเริ่มต้น
ชื่อเรื่อง	ข้อความที่จะแสดงเป็น ชื่อ ของกล่องโต้ตอบ แบบอักษรขนาดใหญ่และโดดเด่นกว่าแบบอักษรข้อความอาจใช้เพื่อแสดงข้อความนี้ ข้อความจะถูกตัดหากยาว
ชื่อเรื่องรอง	ข้อความที่จะแสดงเป็น ชื่อเรื่องรอง ของกล่องโต้ตอบ แบบอักษรขนาดใหญ่และโดดเด่นกว่าแบบอักษรข้อความอาจใช้เพื่อแสดงข้อความนี้ ข้อความจะถูกตัดหากยาว

Confirm จะคืนค่าเป็น จริง หากมีการเลือกปุ่ม ยืนยัน ไม่เช่นนั้นจะเป็น เท็จ

ใช้ฟังก์ชัน Notify เพื่อแสดงข้อความที่ด้านบนของแอปที่ไม่จำเป็นต้องปิด

ไวยากรณ์

ยืนยัน( ข้อความ [, OptionsRecord ] )

• ข้อความ – จำเป็น ข้อความที่จะแสดงให้ผู้ใช้เห็น
• OptionsRecord - เลือกได้ ระบุการตั้งค่าตัวเลือกสำหรับกล่องโต้ตอบ ตัวเลือกบางตัวอาจไม่สามารถใช้ได้ในทุกแพลตฟอร์มและได้รับการจัดการบนพื้นฐาน "ความพยายามอย่างดีที่สุด"

ตัวอย่าง

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

กล่องโต้ตอบการยืนยันอย่างง่าย โดยขอให้ผู้ใช้ยืนยันการลบเรกคอร์ดก่อนที่จะลบ เว้นแต่ผู้ใช้จะกดปุ่ม "ตกลง" ปุ่มบันทึกจะไม่ถูกลบ

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

กล่องโต้ตอบเดียวกับตัวอย่างที่แล้ว แต่เพิ่มข้อความชื่อ

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

ถามสีโปรดจากผู้ใช้ โดยบันทึกผลลัพธ์เป็นตัวแปรส่วนกลาง ผลลัพธ์ที่จะอยู่ใน FavColor จะเป็นสตริงข้อความ "สีแดง" หรือ "สีเขียว" ตามตัวเลือก ยืนยัน "สีแดง" เป็นค่าเริ่มต้น ใช้งานได้เฉพาะบนแพลตฟอร์มที่รองรับตัวเลือก ConfirmButton และ CancelButton

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

แสดงข้อความเหมือนกับฟังก์ชัน Notify แต่เป็นโมดอลและผู้ใช้ต้องเลือกปุ่มเพื่อดำเนินการต่อ ใช้ในเวลาที่ผู้ใช้ต้องรับทราบข้อความก่อนดำเนินการต่อ ในสถานการณ์นี้ ปุ่มใดที่เลือกไม่สำคัญและไม่ได้ตรวจสอบผลลัพธ์