Freigeben über

Kombinationsfeld-Steuerelement in Power Apps

Ein Steuerelement, mit dem Benutzer auswahlmöglichkeiten aus den bereitgestellten Optionen treffen können. Unterstützt Die Suche und mehrfache Auswahl.

Description

Mit einem Kombinationsfeld-Steuerelement können Sie nach Elementen suchen, die Sie auswählen. Die Suche wird serverseitig in der SearchField-Eigenschaft ausgeführt, sodass die Leistung von großen Datenquellen nicht beeinflusst wird.

Der Einzel- oder Mehrfachauswahlmodus wird über die SelectMultiple-Eigenschaft konfiguriert.

Beim Suchen nach auszuwählenden Elementen können Sie für jedes Element einen einzelnen Datenwert, zwei Werte oder ein Bild und zwei Werte (Person) anzeigen, indem Sie die Layouteinstellungen im Datenbereich ändern.

Wenn Sie das Steuerelement auf kleinen Bildschirmen anzeigen, wird das Elementlisten-Flyout zu einem Vollbild-Steuerelement, um die Benutzerfreundlichkeit zu verbessern.

Hinweis

Wenn Sie nach Elementen mit Zahlen suchen möchten, konvertieren Sie Zahlen in Text mit der Funktion "Text() ". Beispiel: Text(12345).

Einschränkungen

Das Kombinationsfeld-Steuerelement hat die folgenden Einschränkungen:

  • Wenn Sie ein Kombinationsfeld-Steuerelement innerhalb eines Katalogs verwenden, werden dessen Auswahlen nicht beibehalten, wenn der Benutzer im Katalog scrollt. Dies ist kein Problem, wenn Sie ein Kombinationsfeld-Steuerelement in einem Katalog verwenden, der nicht scrollt. Zurzeit ist keine Problemumgehung verfügbar.

Personenauswahl

Wenn Sie kombinationsfeld als Personenauswahl verwenden möchten, wählen Sie die Vorlage " Person " aus den Layouteinstellungen im Datenbereich aus, und konfigurieren Sie die zugehörigen Dateneigenschaften, die für die folgende Person angezeigt werden sollen.

Schlüsseleigenschaften

Elemente – Die Datenquelle, aus der Auswahl getroffen werden kann.

DefaultSelectedItems – Die ursprünglich ausgewählten Elemente, bevor der Benutzer mit dem Steuerelement interagiert.

Hinweis

Die Standardeigenschaft ist veraltet, verwenden Sie stattdessen DefaultSelectedItems .

SelectedItems – Liste der ausgewählten Elemente, die sich aus der Benutzerinteraktion ergeben.

Ausgewählt – Das letzte ausgewählte Element, das sich aus der Benutzerinteraktion ergibt.

SelectMultiple – Gibt an, ob der Benutzer ein einzelnes Element oder mehrere Elemente auswählen kann.

IsSearchable – Gibt an, ob der Benutzer vor der Auswahl nach Elementen suchen kann.

Hinweis

IsSearchable kann nur für eine Datenquelle aktiviert werden, die mindestens ein Textfeld enthält. Der Ausdruck "Items " muss delegierbar sein, damit Abfragen mit der Suche delegiert werden können. Das heißt, Wenn-Anweisungen innerhalb des Items-Ausdrucks werden nicht unterstützt.

SearchFields – Die Datenfelder der Datenquelle, die durchsucht werden, wenn der Benutzer Text eingibt.

Hinweis

Um nach mehreren Feldern zu suchen, legen Sie die SearchFields-Eigenschaft in diesem Format fest: ["MyFirstColumn", "MySecondColumn"]. Nur Textfelder werden unterstützt.

Zusätzliche Eigenschaften

AccessibleLabel – Bezeichnung für Bildschirmsprachausgaben.

BorderColor – Die Farbe des Rahmens eines Steuerelements.

BorderStyle – Gibt an, ob der Rahmen eines Steuerelements einfarbig, gestrichelt, gepunktet oder None ist.

BorderThickness – Die Stärke des Rahmens eines Steuerelements.

DisplayFields – Liste der felder, die für jedes Element angezeigt werden, das von der Suche zurückgegeben wird. Am einfachsten können Sie über den Datenbereich auf der Registerkarte "Eigenschaften" konfigurieren.

Hinweis

Um mehrere Anzeigefelder in der angegebenen Vorlage zu aktualisieren, legen Sie die DisplayFields-Eigenschaft in diesem Format fest: ["MyFirstColumn", "MySecondColumn"].

DisplayMode – Ob das Steuerelement Benutzereingaben (Bearbeiten) zulässt, zeigt nur Daten (Ansicht) an oder ist deaktiviert (deaktiviert).

FocusedBorderColor – Die Farbe des Rahmens eines Steuerelements, wenn das Steuerelement fokussiert ist.

FocusedBorderThickness – Die Stärke des Rahmens eines Steuerelements, wenn das Steuerelement fokussiert ist.

Höhe – Der Abstand zwischen den oberen und unteren Rändern eines Steuerelements.

InputTextPlaceholder – Anweisungstext, der Endbenutzern angezeigt wird, wenn keine Elemente ausgewählt sind.

OnChange – Aktionen, die ausgeführt werden sollen, wenn der Benutzer eine Auswahl ändert.

OnNavigate – Aktionen, die ausgeführt werden sollen, wenn der Benutzer ein Element auswählt.

OnSelect – Aktionen, die ausgeführt werden sollen, wenn der Benutzer auf ein Steuerelement tippt oder auswählt.

TabIndex – Tastaturnavigationsreihenfolge im Verhältnis zu anderen Steuerelementen.

Sichtbar – Ob ein Steuerelement angezeigt oder ausgeblendet ist.

Width – Der Abstand zwischen den linken und rechten Rändern eines Steuerelements.

X – Der Abstand zwischen dem linken Rand eines Steuerelements und dem linken Rand des übergeordneten Containers (Bildschirm, wenn kein übergeordneter Container).

Y – Der Abstand zwischen dem oberen Rand eines Steuerelements und dem oberen Rand des übergeordneten Containers (Bildschirm, wenn kein übergeordneter Container).

Hinweis

Flyoutrahmeneigenschaften werden durch Border-Eigenschaften gesteuert.

Examples

Einfaches Kombinationsfeld

Die Schritte in diesem Beispiel gelten für jede Datenquelle, die Tabellen bereitstellt, aber um diese Schritte genau auszuführen, verwenden Sie eine Umgebung mit Microsoft Dataverse-Datenbank mit Beispieldaten.

  1. Wählen Siedas Feld "Eingabekombination>einfügen>" aus, und nennen Sie es "Combobox1".

  2. Öffnen Sie im Eigenschaftenbereich auf der rechten Seite des Bildschirms die Liste " Datenquelle auswählen " (neben "Elemente"), und fügen Sie dann eine Datenquelle wie die Tabelle "Konten" 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ärer Text ", und wählen Sie dann die Spalte " Primärer Name " aus, die im Kombinationsfeld-Steuerelement angezeigt wird.

  5. Wenn Sie die ALT-TASTE gedrückt halten, wählen Sie den Abwärtspfeil aus, um das Kombinationsfeld-Steuerelement zu öffnen.

    Das Steuerelement zeigt die Daten aus dem primären Namen an, den Sie in der von Ihnen angegebenen Datenquelle angegeben haben.

(Optional) Standardmäßiges Anzeigen des ersten Datensatzes

  1. Legen Sie die DefaultSelectedItems-Eigenschaft auf diesen Ausdruck fest, und ersetzen Sie DataSource durch den Namen Ihrer Datenquelle:

    First(DataSource)

(Optional) Anzeigen des ausgewählten Kontonamenwerts in einer Bezeichnung

  1. Wählen Sie "Textbezeichnung einfügen>" und dann "Beschriftung" aus.

  2. Legen Sie die Text-Eigenschaft auf diesen Ausdruck fest, und ersetzen Sie Text durch die folgende Formel:

    If(CountRows(ComboBox1.SelectedItems)>0, Concat(ComboBox1.SelectedItems,'Account Name',", "), "NO SELECTED ITEM")

    Hinweis

    Die If-Anweisung überprüft, wie möglicherweise ausgewählte Elemente vorhanden sind, und zeigen sie in einer durch Trennzeichen getrennten Bezeichnung oder einer Meldung "NO SELECTED ITEM" an, wenn sie leer sind.

Simulieren des einfachen Dropdownverhaltens

Durch Festlegen von IsSearchable auf "false" und "SelectMultiple " auf "false" können Sie dieselbe Funktionalität eines Dropdowns erzielen.

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

  2. Öffnen Sie im Eigenschaftenbereich auf der rechten Seite des Bildschirms die Liste " Datenquelle auswählen " (neben " Elemente"), 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. Öffnen Sie im Datenbereich die Liste des primären Texts , und wählen Sie dann die Spalte aus, die im Kombinationsfeld-Steuerelement angezeigt werden soll.

  5. Legen Sie die IsSearchable-Eigenschaft auf "false" fest.

  6. Legen Sie die SelectMultiple-Eigenschaft auf "false" fest.

  7. Wenn Sie die ALT-TASTE gedrückt halten, wählen Sie den Abwärtspfeil aus, um das Kombinationsfeld-Steuerelement zu öffnen.

    Das Steuerelement zeigt die Daten aus der Spalte an, die Sie in der von Ihnen angegebenen Datenquelle angegeben haben.

    Hinweis

    Der Text "Elemente suchen" ist verschwunden, und Sie können nur ein einzelnes Element auswählen.

Richtlinien für Eingabehilfen

Farbkontrast

Es muss ein ausreichender Farbkontrast zwischen:

  • ChevronFill und ChevronBackground
  • ChevronHoverFill und ChevronHoverBackground
  • SelectionColor und SelectionFill
  • SelectionFill und Füllung
  • SelectionTagColor und SelectionTagFill

Dies ist zusätzlich zu den Standardfarbkontrastanforderungen erforderlich.

Unterstützung für Sprachausgabe

  • AccessibleLabel muss vorhanden sein.

    Hinweis

    Auf Touchscreens können Benutzer der Sprachausgabe den Inhalt des Kombinationsfelds sequenziell navigieren. Das Kombinationsfeld fungiert als Schaltfläche, die den Inhalt anzeigt oder ausblendet, wenn es ausgewählt ist.

Tastaturunterstützung

  • TabIndex muss null oder größer sein, damit Tastaturbenutzer zu ihr navigieren können.

  • Fokusindikatoren müssen deutlich sichtbar sein. Verwenden Sie "FocusedBorderColor " und " FocusedBorderThickness ", um dies zu erreichen.

    Hinweis

    Die TAB-TASTE navigiert zum oder weg vom Kombinationsfeld. Pfeiltasten navigieren im Inhalt des Kombinationsfelds. Die Escapetaste schließt die Dropdownliste, wenn sie geöffnet wird.

  • Last updated on