ProgressIndicator έλεγχος

Άρθρο
03/21/2023

Ένα στοιχείο ελέγχου που χρησιμοποιείται για τη δημιουργία μιας εμπειρίας φόρτωσης.

Σημείωμα

Βρέθηκε πλήρης τεκμηρίωση και πηγαίος κώδικας στο αρχείο φύλαξης στοιχείων κωδικών GitHub.

Στοιχείο ελέγχου ProgressIndicator.

Description

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

Αυτό το στοιχείο κώδικα παρέχει ένα πρόγραμμα περιτύλιξης γύρω από το στοιχείο ελέγχου περιβάλλοντος εργασίας χρήστη Fluent ProgressIndicator για χρήση σε εφαρμογές καμβά και προσαρμοσμένες σελίδες. Ανατρέξτε στην τεκμηρίωση στοιχείων για βέλτιστες πρακτικές.

Ιδιότητες

Ιδιότητες κλειδιού

Ιδιότητα	Description
`Label`	Προαιρετική ετικέτα για κουμπί αυξομείωσης.
`Percentage Complete`	Ποσοστό της λειτουργίας που ολοκληρώθηκε, σε κλίμακα από 0 έως 1. Εάν δεν οριστεί η ένδειξη Απεριόριστο θα εμφανιστεί.
`TypeOfIndicator`	Προσδιορίζει τον τύπο του στυλ ένδειξης. Επιλογές: `Default Indicator` ή `IndeterminateIndicator`
`HideProgressState`	Καθορισμός true για απόκρυψη της κατάστασης προόδου
`BarHeight`	Καθορισμός του ύψους της γραμμής, όπως ισχύει

Ιδιότητες ύφους

Ιδιότητα Description

Theme Αποδέχεται μια συμβολοσειρά JSON που δημιουργείται με τη χρήση της Σχεδίασης θέματος περιβάλλοντος εργασίας χρήστη Fluent (windows.net). Αν αφήσετε αυτό το κενό, θα χρησιμοποιηθεί το προεπιλεγμένο θέμα που ορίζεται από το Power Apps. Δείτε θέματα για οδηγία για τον τρόπο ρύθμισης παραμέτρων.

AccessibilityLabel Ετικέτα aria προγράμματος ανάγνωσης οθόνης

Ιδιότητα	Description
`Theme`	Αποδέχεται μια συμβολοσειρά JSON που δημιουργείται με τη χρήση της Σχεδίασης θέματος περιβάλλοντος εργασίας χρήστη Fluent (windows.net). Αν αφήσετε αυτό το κενό, θα χρησιμοποιηθεί το προεπιλεγμένο θέμα που ορίζεται από το Power Apps. Δείτε θέματα για οδηγία για τον τρόπο ρύθμισης παραμέτρων.
`AccessibilityLabel`	Ετικέτα aria προγράμματος ανάγνωσης οθόνης

Συμπεριφορά

Εμφάνιση προόδου φόρτωσης

Κάντε το ίδιο το στοιχείο ελέγχου ProgressIndicator (ή την επιφάνεια που βρίσκεται μέσα) ορατό κατά την έναρξη μιας διεργασίας και, στη συνέχεια, ενημερώστε μια μεταβλητή με την τιμή, καθώς θα ολοκληρωθούν τμήματα της διεργασίας. Αποκρύψτε το όταν η διεργασία είναι πλήρης. Χρησιμοποιήστε μια μεταβλητή για να ελέγξετε την ορατότητα του στοιχείου ελέγχου και ενημερώστε τις τιμές μεταξύ των μειζόνων μπλοκ κωδικού της διεργασίας που χρειάζεται να υποδειχθούν.

UpdateContext({ var_showProgress: true , var_progressValue: 0 });

/* Some code ... */

UpdateContext({ var_progressValue: 25 });

/* Some code ... */

UpdateContext({ var_progressValue: 50 });

/* Some code ... */

UpdateContext({ var_progressValue: 75 });

/* Some code ... */

UpdateContext({ var_progressValue: 100 });

Notify("Successfully completed process", NotificationType.Success);

UpdateContext({ var_showProgress: false });

Δώστε τη μεταβλητή var_showProgress ως τιμή για την ιδιότητα Visible του ProgressIndicator (ή την επιφάνεια που την περιέχει) και αντιστοιχίστε τη μεταβλητή var_progressValue για την ιδιότητα Value.

Περιορισμοί

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

Κοινή χρήση μέσω