Picker έλεγχος

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

Σημείωμα

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

Description

Οι επιλογείς χρησιμοποιούνται για την επιλογή ενός ή περισσότερων στοιχείων, όπως ετικετών ή αρχείων, από μια μεγάλη λίστα.

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

Το στοιχείο κώδικα επιλογέα ετικετών παρέχει τις ακόλουθες δυνατότητες:

1. Συνδέεται με μια συλλογή εισόδου για τις επιλεγμένες ετικέτες.
2. Συνδέεται με μια συλλογή εισόδου για τις προτεινόμενες ετικέτες.
3. Επιτρέπει στους χρήστες να επιλέξουν από προτάσεις ή να καταχωρήσουν μια ετικέτα ελεύθερου κειμένου.
4. Αυξάνει το συμβάν Αλλαγή όταν ένας χρήστης προσθέτει ή καταργεί μια ετικέτα.
5. Επιτρέπει την εστίαση συνόλου μέσω προγραμματισμού.

Σύνολα δεδομένων

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

• Tags
  • TagsDisplayName
• Suggestions
  • SuggestionsDisplayName
  • SuggestionSubDisplayName

Το σύνολο δεδομένων Suggestions πρέπει να φιλτραριστεί με χρήση της ιδιότητας εξόδου SearchTerm, για παράδειγμα.

Search(colSuggestions,TagPicker.SearchTerm,"name")

Ιδιότητες

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

Ιδιότητα	Description
Items	Μια συλλογή (πίνακας) ετικετών. Η εφαρμογή είναι υπεύθυνη για την προσθήκη ή την κατάργηση ετικετών σε απόκριση της αύξησης των συμβάντων Προσθήκη ή Κατάργηση στοιχείου (περιγράφεται στην παρακάτω ενότητα συμβάντος OnChange).
Suggestions_Items	Μια συλλογή (πίνακας) προτάσεων.
TagMaxWidth	Το μέγιστο πλάτος των ετικετών κατά την απόδοση. Το κείμενο υπερχείλισης θα περικόπτεται με αποσιωπητικά και μια συμβουλή εργαλείου κατάδειξης εμφανίζει το πλήρες κείμενο.
AllowFreeText	Όταν πληκτρολογείτε μια τιμή, μην επιλέγετε αυτόματα την πρώτη πρόταση, ώστε να παρέχεται μια καταχώρηση ελεύθερου κειμένου αντί να επιλέγετε από μια προκαθορισμένη λίστα.
SearchTermToShortMessage	Το μήνυμα που θα εμφανίζεται όταν το όρος αναζήτησης είναι μικρότερο από το MinimumSearchTermLength.
HintText	Το μήνυμα προς εμφάνιση μέσα στον Επιλογέα όταν δεν παρέχεται κανένας όρος αναζήτησης.
NoSuggestionsFoundMessage	Το μήνυμα που θα εμφανίζεται όταν η συλλογή Προτάσεις δεν περιέχει αποτελέσματα.
MinimumSearchTermLength	Ο ελάχιστος αριθμός χαρακτήρων για ενεργοποίηση των αναδυόμενων προτάσεων.
MaxTags	Ο μέγιστος αριθμός ετικετών που μπορούν να προστεθούν. Μετά από αυτόν τον αριθμό, ο επιλογέας ετικετών θα είναι μόνο για εκ νέου, έως ότου καταργηθεί μια ετικέτα.
Error	True όταν θα πρέπει να εμφανίζεται το κόκκινο περίγραμμα σφάλματος.

Items Καταλύματα

Ιδιότητα	Description
TagsDisplayName	Έχει οριστεί στο όνομα της στήλης που περιέχει την ετικέτα εμφανιζόμενο όνομα.

Suggestions Καταλύματα

Ιδιότητα	Description
SuggestionsDisplayName	έχει οριστεί στο όνομα της στήλης που περιέχει το εμφανιζόμενο όνομα πρότασης.
SuggestionsSubDisplayName	(Προαιρετικό) ορίστε το όνομα της στήλης που περιέχει τη δευτερεύουσα γραμμή κειμένου.

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

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

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

Ιδιότητα	Description
Input Event	Ορίστε στο συμβάν για αποστολή στο TagPicker

Ιδιότητες εξόδου

Ιδιότητα	Description
SearchTerm	Το κείμενο που εισάγεται στον Επιλογέα ετικετών και μπορεί να χρησιμοποιηθεί για το φιλτράρισμα το σύνολο δεδομένων των προτάσεων.
TagsDisplayName	το κείμενο που χρησιμοποιείται για τη δημιουργία μιας νέας Ετικέτας όταν το συμβάν Κατά την αλλαγή πυροδοτείται
AutoHeight	Όταν ο επιλογέας ετικετών αναδιπλώνεται σε πολλές γραμμές, η ιδιότητα Auto Height μπορεί να χρησιμοποιηθεί για τον έλεγχο του ύψους ενός ενεργητικού ύψους κοντέινερ.

Συμπεριφορά

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

Συμβάν OnChange

Το στοιχείο TagPicker δημιουργεί ένα συμβάν OnChange όταν προστίθενται ή καταργούνται οι ετικέτες. Οι ιδιότητες που χρησιμοποιούνται είναι:

Ιδιότητα	Description
TagEvent	Το όνομα του συμβάντος που προέκυψε
TagKey	Το κλειδί του στοιχείου που έχει αναδείξει το συμβάν (εάν το συμβάν σχετίζεται με μια ετικέτα)

Το συμβάν πρέπει να περιέχει μια παράσταση παρόμοια με:

If( TagPicker.TagEvent = "Add" && CountRows(Filter(colTags,name=TagPicker.TagsDisplayName)) = 0,
    Collect( colTags, { name:TagPicker.TagsDisplayName })
);

If( TagPicker.TagEvent="Remove",
 RemoveIf( colTags,name=Text(TagPicker.TagsDisplayName) )
);

Περιορισμοί

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