ContextMenu έλεγχος

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

Σημείωμα

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

Description

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

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

Ιδιότητες

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

Ιδιότητα	Description
Items	Τα στοιχεία ενέργειας προς απόδοση. Το πρώτο στοιχείο θεωρείται το ριζικό στοιχείο.

Items Καταλύματα

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

Σημείωμα

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

Παράδειγμα

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

  Table(
      {
          ItemKey: "File",
          ItemIconName: "save",
          ItemDisplayName: "Save",
          ItemOverflow:true
      },
       {
          ItemKey: "Delete",
          ItemIconName: "Delete",
          ItemDisplayName: "Delete",
          ItemOverflow:true
      }
  )
  

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

Ιδιότητα	Description
Theme	Αποδέχεται μια συμβολοσειρά JSON που δημιουργείται με τη χρήση της Σχεδίασης θέματος περιβάλλοντος εργασίας χρήστη Fluent (windows.net). Αν αφήσετε αυτό το κενό, θα χρησιμοποιηθεί το προεπιλεγμένο θέμα που ορίζεται από το Power Apps. Αν αφήσετε αυτό το κενό, θα χρησιμοποιηθεί το προεπιλεγμένο θέμα που ορίζεται από το Power Apps. Δείτε θέματα για οδηγία για τον τρόπο ρύθμισης παραμέτρων.
Chevron	Εμφάνιση ή απόκρυψη των κάτω εισαγωγικών στο κουμπί ρίζας
IconColor	Προαιρετικό. χρώμα του εικονιδίου στο κουμπί του μενού περιβάλλοντος.
HoverIconColor	Προαιρετικό. χρώμα του εικονιδίου όταν καταδεικνύει το κουμπί του μενού περιβάλλοντος.
IconSize	Προαιρετικό. Σε pixel, το μέγεθος του εικονιδίου στο κουμπί του μενού περιβάλλοντος.
FontSize	Προαιρετικό. Σε pixel, το μέγεθος του κειμένου στο κουμπί του μενού περιβάλλοντος.
FontColor	Προαιρετικό. το χρώμα του κειμένου στο κουμπί του μενού περιβάλλοντος.
HoverFontColor	Προαιρετικό. το χρώμα του κειμένου όταν καταδεικνύει το κουμπί του μενού περιβάλλοντος.
FillColor	Προαιρετικό. το χρώμα φόντου του κουμπιού του μενού περιβάλλοντος.
HoverFillColor	Προαιρετικό. το χρώμα φόντου όταν καταδεικνύει το κουμπί του μενού περιβάλλοντος.
TextAlignment	Η στοίχιση του κειμένου του κουμπιού. Πιθανές τιμές: Κέντρο, Αριστερά ή Δεξιά
AccessibilityLabel	Ετικέτα aria προγράμματος ανάγνωσης οθόνης

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

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

Συμπεριφορά

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

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

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

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

  Switch( Self.Selected.ItemKey,
    /* Action for ItemKey 1 */
    "File", false,
    
    /* Action for ItemKey 2 */
    "Delete", false,
  
    /* Default action */
        false
  )

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

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

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

Π.χ.

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

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

Περιορισμοί

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