Συνάρτηση Confirm

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

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

Περιγραφή

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

Ο χρήστης πρέπει να επιλέξει ένα από τα κουμπιά προτού κλείσετε το παράθυρο διαλόγου. Εκτός από την επιλογή του κουμπιού Άκυρο, το παράθυρο διαλόγου μπορεί να απορριφθεί μέσω κινήσεων ειδικά για την πλατφόρμα (όπως το πλήκτρο Esc ή το κλικ έξω από το παράθυρο διαλόγου). Στις εφαρμογές καμβά, αυτή η διαδρομή απόλυσης δεν αντιμετωπίζεται ως καμία ενέργεια (δηλαδή, επιστρέφει blank).

Note

Στις εφαρμογές καμβά, η Confirm συνάρτηση χρησιμοποιεί το παράθυρο διαλόγου Fluent. Βεβαιωθείτε ότι είναι ενεργοποιημένα τα σύγχρονα στοιχεία ελέγχου. Διαφορετικά, εμφανίζεται το παράθυρο διαλόγου του εγγενούς προγράμματος περιήγησης.

Σύνταξη

Confirm( Message [, OptionsRecord ] )
  • Μήνυμα - Απαιτείται. Το μήνυμα που θα εμφανίζεται στον χρήστη.
  • OptionsRecord - Προαιρετικό. Παράσχετε ρυθμίσεις επιλογής για το πλαίσιο διαλόγου. Δείτε παρακάτω για τις διαθέσιμες επιλογές.

Επιλογές

Χρησιμοποιήστε την παράμετρο OptionsRecord για να προσαρμόσετε το παράθυρο διαλόγου επιβεβαίωσης:

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

Προεπιλεγμένη συμπεριφορά

Ετικέτες κουμπιών: Εάν δεν παρέχετε προσαρμοσμένες ετικέτες κουμπιών, Confirm χρησιμοποιεί μεταφρασμένο προεπιλεγμένο κείμενο κουμπιού:

  • Στις εφαρμογές καμβά (προεπισκόπηση), οι προεπιλογές είναι "Confirm" και "Άκυρο" (μεταφρασμένες).
  • Στις εφαρμογές βάσει μοντέλου, οι προεπιλογές είναι "OK" και "Άκυρο" (μεταφρασμένες).

Τιμή επιστροφής:Confirm Η επιστρέφει true εάν ο χρήστης επιλέξει το κουμπί επιβεβαίωσης και false σε διαφορετική περίπτωση.

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

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

Απλή επιβεβαίωση πριν από την κατάργηση μιας εγγραφής

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.

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

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

Εφαρμογές τύπου Canvas

Confirm πριν από τη διαγραφή

Χρησιμοποιείται Confirm για την αποφυγή τυχαίας διαγραφής εγγραφών:

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

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

Confirm πριν από την αποθήκευση μιας φόρμας

Χρησιμοποιείται Confirm για την επικύρωση της πρόθεσης χρήστη πριν από την υποβολή δεδομένων:

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

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

Αποθήκευση αποτελέσματος σε μια μεταβλητή για πολλές ενέργειες

Αποθηκεύστε το αποτέλεσμα επιβεβαίωσης που θα χρησιμοποιηθεί σε πολλαπλές πράξεις κατάντη:

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

Το δυαδικό αποτέλεσμα αποθηκεύεται στο varConfirmed και μπορεί να αναφέρεται πολλές φορές για λογική υπό όρους.

Πλήρης προσαρμογή με όλες τις επιλογές

Παρουσιάζουν όλες τις διαθέσιμες επιλογές προσαρμογής:

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

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

Συνήθεις ερωτήσεις για

Μπορώ να κρύψω το κουμπί Ακύρωση;

Όχι. Η τρέχουσα σχεδίαση εμφανίζει πάντα τα Confirm κουμπιά και Άκυρο. Οι χρήστες πρέπει να έχουν τη δυνατότητα να απορρίψουν ή να ακυρώσουν το παράθυρο διαλόγου.

Μπορώ να προσθέσω ένα τρίτο κουμπί ή περισσότερες από δύο επιλογές;

Όχι. Confirm Το υποστηρίζει ακριβώς δύο επιλογές: μια ενέργεια επιβεβαίωσης και μια ενέργεια ακύρωσης. Για σενάρια που απαιτούν πολλές επιλογές, εξετάστε το ενδεχόμενο να χρησιμοποιήσετε ένα διαφορετικό μοτίβο περιβάλλοντος εργασίας χρήστη, όπως μια προσαρμοσμένη οθόνη ή ένα στοιχείο ελέγχου αναπτυσσόμενης λίστας.

Αποκλείει Confirm άλλες λειτουργίες;

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

Δείτε επίσης

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

  • Last updated on