Freigeben über


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.

  1. Wählen Sie Einfügen > Eingabe > Kombinationsfeld, und nennen Sie es „Combobox1“.

  2. Ö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.

  3. Wählen Sie im selben Bereich Bearbeiten (neben Felder) aus.

  4. Ö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.

  5. 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

  1. 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

  1. Wählen Sie Einfügen > Textbeschriftung und dann Beschriftung aus.

  2. 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.

  1. Wählen Sie Einfügen > Eingabe und dann Kombinationsfeld aus.

  2. Ö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.

  3. Wählen Sie im selben Bereich Bearbeiten (neben Felder) aus.

  4. 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.

  5. Legen Sie die Eigenschaft IsSearchable auf „False“ fest.

  6. Legen Sie die Eigenschaft SelectMultiple auf „False“ fest.

  7. 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).