Kombinationsfeld-Steuerelement in Power Apps
Ein Steuerelement, das es Benutzern ermöglicht, unter Optionen eine Auswahl zu treffen. Unterstützt die Suche und Mehrfachauswahl.
Beschreibung
Mit einem Kombinationsfeld-Steuerelement können Sie Elemente suchen, die Sie auswählen. Die Suche erfolgt serverseitig mit der SearchField-Eigenschaft. Deshalb verursachen sehr große Datenquellen keine Leistungseinbuße.
Der Einfach- oder Mehrfachauswahlmodus wird mit der SelectMultiple-Eigenschaft konfiguriert.
Wenn Sie auszuwählende Elemente suchen, können Sie für jedes Element festlegen, dass ein einzelner Datenwert, zwei Werte oder ein Bild und zwei Werte (Person) angezeigt werden. Hierzu ändern Sie die Einstellung „Layout“ im Bereich „Daten“.
Bei der Anzeige auf kleinen Bildschirmen wird das Flyout mit der Artikelliste zu einer Vollbildsteuerung für eine bessere Benutzerfreundlichkeit.
Hinweis
Wenn Sie nach Elementn mit Zahlen suchen möchten, konvertieren Sie Zahlen in Text mit der Text() Funktion. Geben Sie beispielsweise Text(12345) ein.
Einschränkungen
Für das Kombinationsfeld-Steuerelement gelten folgende Einschränkungen:
- Wenn Sie ein Kombinationsfeld-Steuerelement innerhalb eines Katalogs verwenden, werden die ausgewählten Optionen nicht beibehalten, sobald der Benutzer durch den Katalog scrollt. Dies ist kein Problem, wenn Sie ein Kombinationsfeld-Steuerelement in einem Katalog verwenden, der Scrollen nicht unterstützt. Eine Problemumgehung ist derzeit nicht verfügbar.
Personenauswahl
Wenn Sie ein Kombinationsfeld als Personenauswahl verwenden möchten, wählen Sie im Datenbereich in den Layouteinstellungen die Vorlage Person aus, und konfigurieren Sie die folgenden Dateneigenschaften, die für die Person angezeigt werden sollen.
Wichtige Eigenschaften
Items – Die Quelle der Daten, aus der Elemente ausgewählt werden können.
DefaultSelectedItems – Die ursprünglich ausgewählten Elemente, bevor der Benutzer mit dem Steuerelement interagiert.
Hinweis
Default Eigenschaft ist außer Betrieb genommen, verwenden Sie stattdessen DefaultSelectedItems.
SelectedItems – Die Liste der aufgrund der Benutzerinteraktion ausgewählten Elemente.
SelectMultiple – Legt fest, ob der Benutzer ein einzelnes Element oder mehrere Elemente auswählen kann.
IsSearchable – Legt fest, ob der Benutzer vor der Auswahl nach Elementen suchen kann.
Hinweis
IsSearchable kann nur für ein Datenquelle aktiviert werden, das mindestens ein Textfeld enthält. Der Items Ausdruck muss delegierbar sein, damit Abfragen bei der Suche delegiert werden können. Das ist, If Aussagen innerhalb des Items Ausdrucks nicht unterstützt werden.
SearchFields: Die Datenfelder der Datenquelle, die durchsucht werden, wenn Benutzer Text eingeben.
Hinweis
Um in mehreren Feldern zu suchen, legen Sie die Eigenschaft SearchFields in diesem Format fest: ["MyFirstColumn", "MySecondColumn"]. Es werden nur Textfelder unterstützt.
Zusätzliche Eigenschaften
AccessibleLabel - Bezeichnung für Sprachausgaben.
BorderColor - Die Farbe des Rahmens eines Steuerelements.
BorderStyle - Legt fest, ob der Rahmen eines Steuerelements Durgehend, Gestrichelt, Gepunktet oder Keine ist.
BorderThickness - Die Linienstärke des Rahmens eines Steuerelements.
DisplayFields – Die Liste der Felder, die für jedes von der Suche zurückgegebene Element angezeigt werden. Diese Eigenschaft lässt sich am einfachsten im Bereich „Daten“ der Optionsregisterkarte „Eigenschaften“ konfigurieren.
Hinweis
Um mehrere Anzeigefelder in einer bestimmten Vorlage zu aktualisieren, legen Sie die Eigenschaft DisplayFields in diesem Format fest: ["MyFirstColumn", "MySecondColumn"].
DisplayMode - Legt fest, ob das Steuerelement Benutzereingaben zulässt (Bearbeiten), ob nur Daten angezeigt werden (Anzeigen) oder ob das Steuerelement deaktiviert ist (Deaktiviert).
FocusedBorderColor - Die Rahmenfarbe eines Steuerelements, wenn das Steuerelement der Fokus ist.
FocusedBorderThickness - Die Rahmendicke eines Steuerelements, wenn das Steuerelement der Fokus ist.
Height - Die Entfernung zwischen dem oberen und unteren Rand eines Steuerelements.
InputTextPlaceholder – Ein Hinweistext, der für Endbenutzer angezeigt wird, wenn kein Element ausgewählt ist.
OnChange – Auszuführende Aktionen, wenn der Benutzer eine Auswahl ändert.
OnNavigate – Auszuführende Aktionen, wenn der Benutzer ein Element auswählt.
OnSelect – Auszuführende Aktionen, wenn der Benutzer auf ein Steuerelement tippt oder es auswählt.
TabIndex: Navigationsreihenfolge der Tastatur in Bezug auf andere Steuerelemente.
Visible - Gibt an, ob ein Steuerelement angezeigt wird oder ausgeblendet ist.
Width - Der Abstand zwischen dem linken und rechten Rand eines Steuerelements.
X – Der Abstand zwischen dem linken Rand eines Steuerelements und dem linken Rand des übergeordneten Containers (vom Bildschirm, wenn kein übergeordneter Container vorhanden ist).
Y – Der Abstand zwischen dem oberen Rand eines Steuerelements und dem oberen Rand des übergeordneten Containers (Vom Bildschirm, wenn kein übergeordneter Container vorhanden ist).
Hinweis
Flyout-Randeigenschaften werden durch Eigenschaften von Grenze bestimmt.
Beispiele
Standardkombinationsfeld
Die Schritte in diesem Beispiel gelten für jede Datenquelle, die Tabellen bereitstellt, aber um diese Schritte genau zu befolgen, verwenden Sie eine Umgebung mit Microsoft Dataverse-Datenbank mit Beispieldaten.
Wählen Sie Einfügen > Eingabe > Kombinationsfeld, und nennen Sie es „Combobox1“.
Öffnen Sie im Bereich Eigenschaften auf der rechten Seite des Bildschirms die Liste Datenquelle auswählen (neben Items), und fügen Sie dann eine Datenquelle wie die Kontentabelle hinzu oder wählen Sie sie aus.
Wählen Sie im selben Bereich Bearbeiten (neben Felder) aus.
Öffnen Sie im Bereich Daten die Liste Primärtext, und wählen Sie dann die Spalte Primärer Name aus, die im Steuerelement Kombinationsfeld angezeigt wird.
Halten Sie die ALT-TASTE gedrückt, und wählen Sie den Abwärtspfeil aus, um das Steuerelement Kombinationsfeld zu öffnen.
Das Steuerelement zeigt die Daten des primären Namens an, den Sie in der von Ihnen angegebenen Datenquelle angegeben haben.
(Optional) Standardmäßig den ersten Datensatz anzeigen
Legen Sie die Eigenschaft DefaultSelectedItems zu diesem Ausdruck fest, indem Sie Datenquelle mit dem Namen Ihrer Datenquelle ersetzen:
First(DataSource)
(Optional) Ausgewählten Wert für den Kontonamen in einer Beschriftung anzeigen
Wählen Sie Einfügen > Textbeschriftung und dann Beschriftung aus.
Legen Sie die Text-Eigenschaft zu diesem Ausdruck fest, indem Sie Text mit der folgenden Formel ersetzen:
If(CountRows(ComboBox1.SelectedItems)>0, Concat(ComboBox1.SelectedItems,'Account Name',", "), "NO SELECTED ITEM")Hinweis
Die If-Anweisung prüft, wie viele ausgewählte Elemente vorhanden sind, und zeigt sie in einer durch Komma getrennten Beschriftung oder einer KEIN AUSGEWÄHLTES ELEMENT-Nachricht an, wenn keine Elemente vorhanden sind.
Einfaches Dropdownverhalten simulieren
Wenn Sie IsSearchable und SelectMultiple auf „False“ festlegen, können Sie die Funktionalität eines Dropdowns erzielen.
Wählen Sie Einfügen > Eingabe und dann Kombinationsfeld aus.
Öffnen Sie im Bereich Eigenschaften auf der rechten Seite des Bildschirms die Liste Datenquelle auswählen (neben Items), und fügen Sie dann eine Datenquelle hinzu oder wählen Sie sie aus.
Wählen Sie im selben Bereich Bearbeiten (neben Felder) aus.
In dem Bereich Daten öffnen Sie die Liste Primärer Text und wählen Sie dann die Spalte aus, die im Steuerelement Kombinationsfeld angezeigt werden soll.
Legen Sie die Eigenschaft IsSearchable auf „False“ fest.
Legen Sie die Eigenschaft SelectMultiple auf „False“ fest.
Halten Sie die ALT-TASTE gedrückt, und wählen Sie den Abwärtspfeil aus, um das Steuerelement Kombinationsfeld zu öffnen.
Das Steuerelement zeigt die Daten aus der Spalte an, die Sie in dem von Ihnen angegebenen Datenquelle angegeben haben.
Hinweis
Der Text „Elemente suchen“ ist ausgeblendet, und Sie können nur ein einzelnes Element auswählen.
Richtlinien für Barrierefreiheit
Farbkontrast
Zwischen den folgenden Eigenschaften muss es einen ausreichenden Farbkontrast geben:
- ChevronFill und ChevronBackground
- ChevronHoverFill und ChevronHoverBackground
- SelectionColor und SelectionFill
- SelectionFill und Fill
- SelectionTagColor und SelectionTagFill
Dies ist ein Zusatz zu den Standardanforderungen für Farbkontraste.
Screenreadersupport
AccessibleLabel muss vorhanden sein.
Hinweis
Auf Touchscreens können Benutzer, die die Sprachausgabe benutzen, der Reihe nach durch die Inhalte des Kombinationsfelds navigieren. Das Kombinationsfeld fungiert als Schaltfläche, die Inhalte anzeigt bzw. ausblendet, wenn diese ausgewählt sind.
Tastaturunterstützung
TabIndex muss gleich Null oder größer sein, damit Tastaturbenutzer dorthin navigieren können.
Fokusindikatoren müssen deutlich sichtbar sein. FocusedBorderColor und FocusedBorderThickness können Ihnen dabei helfen.
Hinweis
Über die TAB-TASTE können Sie zum Kombinationsfeld navigieren oder dieses schließen. Über die Pfeiltasten können Sie durch die Inhalte des Kombinationsfelds navigieren. Über die ESC-Taste können Sie die Dropdownliste ggf. schließen.
Hinweis
Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)
Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).