Συνάρτηση Confirm

Ισχύει για: Εφαρμογές βάσει μοντέλου

Εμφανίστε ένα παράθυρο διαλόγου επιβεβαίωσης για τον χρήστη.

Description

Σημείωμα

Αυτήν τη στιγμή, η συνάρτηση Confirm είναι διαθέσιμη μόνο κατά τη σύνταξη εντολών Power Fx για εφαρμογές βάσει μοντέλου.

Η συνάρτηση Confirm εμφανίζει ένα παράθυρο διαλόγου στο επάνω τμήμα της τρέχουσας οθόνης. Παρέχονται δύο κουμπιά: ένα κουμπί επιβεβαίωσης και ένα κουμπί ακύρωσης, τα οποία επαναφέρονται ως μεταφρασμένες εκδόσεις του "OK" και του "Άκυρο", αντίστοιχα. Ο χρήστης πρέπει να επιβεβαιώσει ή να ακυρώσει πριμ από το κλείσιμο του παραθύρου διαλόγου και η λειτουργία επιστρέφει. Εκτός από το κουμπί του παραθύρου διαλόγου, μπορεί επίσης να επιλεγεί η ακύρωση με το πλήκτρο ESC ή άλλες κινήσεις που είναι συγκεκριμένες για την πλατφόρμα.

Η παράμετρος Message εμφανίζεται στο σώμα του παραθύρου διαλόγου. Εάν το μήνυμα είναι πολύ μεγάλο, μπορεί να περικοπεί ή μπορεί να παρέχεται μια γραμμή κύλισης.

Χρησιμοποιήστε την παράμετρο OptionsRecord για να καθορίσετε επιλογές για το παράθυρο διαλόγου. Δεν είναι διαθέσιμες όλες οι επιλογές σε κάθε πλατφόρμα και ο χειρισμός τους γίνεται με βάση την καλύτερη δυνατή προσπάθεια. Αυτές οι επιλογές δεν υποστηρίζονται σε εφαρμογές καμβά.

Πεδίο επιλογών	Description
ΕπιβεβαίωσηΚουμπί	Το κείμενο που εμφανίζεται στο κουμπί επιβεβαίωση, αντικαθιστώντας το προεπιλεγμένο, μεταφρασμένο κείμενο "OK".
ΑκύρωσηΚουμπί	Το κείμενο που εμφανίζεται στο κουμπί ακύρωση, αντικαθιστώντας το προεπιλεγμένο, μεταφρασμένο κείμενο "Ακύρωση".
Τίτλος	Το κείμενο που θα εμφανίζεται ως ο τίτλος του παραθύρου διαλόγου. Μια μεγαλύτερη γραμματοσειρά με πιο έντονη γραφή από αυτήν της γραμματοσειράς του μηνύματος, μπορεί να χρησιμοποιηθεί για την εμφάνιση αυτού του κειμένου. Το κείμενο θα περικοπεί, εάν είναι πολύ μεγάλο.
Υπότιτλος	Το κείμενο που θα εμφανίζεται ως ο υπότιτλος του παραθύρου διαλόγου. Μια μεγαλύτερη γραμματοσειρά με πιο έντονη γραφή από αυτήν της γραμματοσειράς του μηνύματος, μπορεί να χρησιμοποιηθεί για την εμφάνιση αυτού του κειμένου. Το κείμενο θα περικοπεί, εάν είναι πολύ μεγάλο.

Η επιλογή Επιβεβαίωση επιστρέφει αληθής εάν έχει επιλεγεί το κουμπί επιβεβαίωσης , ψευδής διαφορετικά.

Χρησιμοποιήστε τη συνάρτηση Notify για να εμφανίσετε ένα διαφημιστικό πλαίσιο μηνύματος στο επάνω μέρος της εφαρμογής, το οποίο δεν χρειάζεται να απορριφθεί.

Σύνταξη

Confirm( Μήνυμα [; OptionsRecord ] )

• Μήνυμα - Απαιτείται. Το μήνυμα που θα εμφανίζεται στον χρήστη.
• OptionsRecord - Προαιρετικό. Παράσχετε ρυθμίσεις επιλογής για το πλαίσιο διαλόγου. Δεν είναι διαθέσιμες όλες οι επιλογές σε κάθε πλατφόρμα και ο χειρισμός τους γίνεται με βάση την καλύτερη δυνατή προσπάθεια.

Παραδείγματα

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

Απλό παράθυρο διαλόγου επιβεβαίωσης, το οποίο ζητάει από το χρήστη να επιβεβαιώσει τη διαγραφή μιας καρτέλας πριν καταργηθεί. Εκτός εάν ο χρήστης πατήσει το "OK", τότε η καρτέλα δεν θα διαγραφεί.

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, αλλά είναι αποκλειστικό και απαιτεί από τον χρήστη να επιλέξει ένα κουμπί για να συνεχίσει. Χρησιμοποιήστε όταν είναι σημαντικό ο χρήστης να επιβεβαιώσει το μήνυμα προτού συνεχίσει. Σε αυτήν την περίπτωση, το κουμπί που επιλέξατε δεν είναι σημαντικό και το αποτέλεσμα δεν ελέγχεται.