CommandBar έλεγχος (έκδοση προεπισκόπησης)

Ένα στοιχείο ελέγχου που χρησιμοποιείται για την εισαγωγή εντολών.

Σημείωμα

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

Description

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

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

Ιδιότητες

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

Ιδιότητα	Description
Items	Τα στοιχεία ενέργειας προς απόδοση

Δομή στοιχείων

Κάθε στοιχείο χρησιμοποιεί το ακόλουθο σχήμα για να απεικονίσει δεδομένα στο στοιχείο.

'Ονομα	Description
ItemDisplayName	Το εμφανιζόμενο όνομα του στοιχείου γραμμής εντολών.
ItemKey	Το κλειδί που θα χρησιμοποιηθεί για να υποδείξει ποιο στοιχείο είναι επιλεγμένο και πότε να προστεθούν υπο-στοιχεία. Τα κλειδιά πρέπει να είναι μοναδικά.
ItemEnabled	Εάν η επιλογή είναι απενεργοποιημένη, ορίζεται σε false.
ItemVisible	Εάν η επιλογή δεν είναι ορατή, ορίζεται σε false.
ItemChecked	Ορίστε την τιμή true εάν η επιλογή είναι ενεργοποιημένη (για παράδειγμα, διαιρέστε τα κουμπιά σε μια γραμμή εντολών).
ItemSplit	Ορίστε την τιμή σε true εάν μπορείτε να κάνετε κλικ στην επιλογή και να τη χρησιμοποιήσετε ως αναπτυσσόμενο μενού αναδυόμενων επιλογών.
ItemIconName	Το εικονίδιο του περιβάλλοντος εργασίας χρήστη Fluent που θα χρησιμοποιηθεί (βλ. εικονίδια περιβάλλοντος εργασίας χρήστη Fluent)
ItemIconColor	Το χρώμα για απόδοση του εικονιδίου ως (π.χ. κατονομαζόμενη, rgb ή δεκαεξαδική τιμή).
ItemIconOnly	Μην εμφανίζετε την ετικέτα κειμένου - μόνο το εικονίδιο.
ItemOverflow	Ορισμός σε true για συμπεριφορά υπερχείλισης
ItemOverflow	Αποδώστε την επιλογή στα στοιχεία υπερχείλισης.
ItemFarItem	Αποδώστε την επιλογή στην ομάδα απομακρυσμένων στοιχείων μιας γραμμής εντολών.
ItemHeader	Αποδώστε το στοιχείο ως κεφαλίδα ενότητας. Εάν υπάρχουν στοιχεία που έχουν το ItemParentKey ορισμένο στο κλειδί αυτού του στοιχείου, τότε αυτά προστίθενται ως στοιχεία σημασιολογικά ομαδοποιημένα κάτω από αυτήν την ενότητα.
ItemTopDivider	Αποδώστε ένα διαχωριστικό στην κορυφή της ενότητας.
ItemDivider	Αποδώστε το στοιχείο ως διαχωριστικό ενοτήτων - ή εάν το στοιχείο είναι κεφαλίδα (ItemHeader = true), τότε ελέγχει αν θα αποδώσει ένα διαχωριστικό στο κάτω μέρος της ενότητας.
ItemParentKey	Απόδοση της επιλογής ως θυγατρικού στοιχείου μιας άλλης επιλογής.

Σημείωμα

• ItemIconColor θα παρακάμψει την τιμή Theme του στοιχείου και θα αγνοήσει άλλα χρώματα κατάστασης (π.χ. απενεργοποιημένα).
• ItemHeader και ItemDivider πρέπει να οριστεί σε true για να αποδοθεί ως διαχωριστικό. Εάν έχει οριστεί σε false, αναμένει άλλες τιμές και θα αποδοθεί κενή.

Παράδειγμα

Παράδειγμα τύπου Power Fx για βασικό Items:

Table(
    {
        ItemKey: "new",
        ItemDisplayName: "New",
        ItemIconName: "Add"
    },
    {
        ItemKey: "edit",
        ItemDisplayName: "Edit",
        ItemIconName: "Edit"
    },{
        ItemKey: "delete",
        ItemDisplayName: "Delete",
        ItemIconName: "Delete"
    },{
        ItemKey: "refresh",
        ItemDisplayName: "Refresh",
        ItemIconName: "refresh"
    },{
        ItemKey: "help",
        ItemDisplayName: "Help",
        ItemIconName: "help"
    }
)
  

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

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

Ιδιότητες συμβάντος

Ιδιότητα	Description
InputEvent	Ένα συμβάν για αποστολή στο στοιχείο ελέγχου. Π.χ. SetFocus.

Συμπεριφορά

Υποστηρίζει το SetFocus ως InputEvent.

Ρύθμιση παραμέτρων συμπεριφοράς "On Select"

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

Αντικαταστήστε τις τιμές false με κατάλληλες παραστάσεις στη γλώσσα Power Fx.

  Switch( Self.Selected.ItemKey,
    /* Action for ItemKey 'new' (e.g., Patch function) */
    "new", false,
    
    /* Action for 'edit' (e.g., Patch function) */
    "edit", false,
    
    /* Action for 'delete' (e.g., Remove function ) */
    "delete", false,
    
    /* Action for 'refresh' (e.g., Refresh function) */
    "refresh", false,
    
    /* Action for 'help' (e.g., email support with the Office 365 connector ) */
    "help", false,
  
    /* Default action */
        false
  )

Ορισμός της εστίασης στο στοιχείο ελέγχου

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

Για να κάνετε κλήσεις στο συμβάν εισόδου, μπορείτε να ορίσετε μια μεταβλητή περιβάλλοντος που συνδέεται με την ιδιότητα Input Event σε μια συμβολοσειρά που ξεκινά με το SetFocus και ακολουθείται από ένα τυχαία στοιχείο για να εξασφαλίσετε ότι η εφαρμογή το εντοπίζει ως αλλαγή.

Παράδειγμα τύπου Power Fx:

UpdateContext({ ctxResizableTextareaEvent:"SetFocus" & Text(Rand()) }));

Στη συνέχεια, η μεταβλητή περιβάλλοντος ctxResizableTextareaEvent θα δεσμευόταν στην ιδιότητα Input Event της ιδιότητας.

Περιορισμοί

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

Δείτε περισσότερες σημειώσεις περιορισμού στις προκλήσεις σχεδίασης στοιχείων.