Katalogsteuerelement in Power Apps

Ein Steuerelement, das andere Steuerelemente enthält und eine Datenmenge anzeigt.

Description

Ein Katalogsteuerelement kann mehrere Datensätze aus einer Datenquelle anzeigen, und jeder Datensatz kann mehrere Datentypen enthalten. Verwenden Sie z. B. ein Katalog-Steuerelement , um mehrere Kontakte mit jedem Element mit Kontaktinformationen anzuzeigen, die einen Namen, eine Adresse und eine Telefonnummer für jeden Kontakt enthalten.

Jedes Datenfeld wird in einem separaten Steuerelement im Katalog-Steuerelement angezeigt. Und Sie können diese Steuerelemente in ihrer Vorlage konfigurieren. Die Vorlage wird als erstes Element im Katalog angezeigt:

• Am linken Rand eines Katalog-Steuerelements in horizontaler/querformater Ausrichtung.
• Und oben in einem Katalog-Steuerelement in vertikaler/Hochformatausrichtung.

Alle Änderungen, die Sie in der Vorlage vornehmen, werden im gesamten Katalogsteuerelement wiedergegeben.

Vordefinierte Vorlagen zum Anzeigen von Bildern und Text in einem Katalog sind verfügbar und ein Katalog für Elemente mit variabler Höhe.

Einschränkungen

Das Katalogsteuerelement hat die folgenden Einschränkungen:

1. Wenn ein Benutzer das Steuerelement für den flexiblen Höhenkatalog vor dem Laden aller Elemente scrollt, wird das aktuell angezeigte Element möglicherweise nach unten und außerhalb der Ansicht verschoben, wenn das Laden der Daten abgeschlossen ist. Um dieses Problem zu vermeiden, verwenden Sie ein Standardkatalog-Steuerelement anstelle der Variante "Flexible Höhe ".To avoid this issue, use a standard Gallery control instead of the Flexible height variant.
2. Die folgenden Steuerelemente werden in einem Katalog nicht unterstützt:
   • Formular anzeigen
   • Formular bearbeiten
   • PDF-Viewer
   • Power BI-Kachel
   • Rich-Text-Editor
   • Scrollbarer Bildschirm (Dynamisches Raster)
   • Web-Strichcodescanner
3. Sie können keinen Katalog innerhalb eines anderen Katalogs hinzufügen, wenn sich letztere bereits in einem anderen Katalog befindet. Die maximale Schachtelungsebene beträgt 2.
4. Die minimale TemplateSize-Größe ist eine. Dies kann dazu führen, dass Steuerelemente im Katalog von den erwarteten X - oder Y-Werten entfernt werden, wenn Sie die Vorlagengröße nicht berücksichtigen.
5. Wenn Sie eine App automatisch aus Daten generieren, speichern Sie die App, und öffnen Sie sie dann erneut, zeigt der Suchkatalog möglicherweise keine Daten sofort an. Um dieses Problem zu beheben, geben Sie mindestens ein Zeichen in das Suchfeld ein, und löschen Sie dann den eingegebenen Text. Der Katalog zeigt dann die Daten erwartungsgemäß an.
6. Wenn ein Katalog ein ComboBox-, DatePicker-, Slider- oder Toggle-Steuerelement mit einer OnChange Regel enthält, die dieselbe Datenquelle oder Auflistung wie der Katalog patcht, kann dies zu unerwarteten oder reduzierten Leistungseinbußen führen. Dies liegt daran, dass eine OnChange Regel, mit der die Datenquelle des Katalogs gepatcht wird, einen nie endenden Zyklus von Patching und Neuladen erstellen kann. Um dieses Problem zu vermeiden, ist es ratsam, keine Regeln zu verwenden OnChange , wenn diese Steuerelemente in einem Katalog platziert werden.

Schlüsseleigenschaften

Standard – Das Element oder der Datensatz aus der Datenquelle, das beim Starten der App im Katalog ausgewählt werden soll.

Elemente – Die Datenquelle, die in einem Steuerelement wie einem Katalog, einer Liste oder einem Diagramm angezeigt wird.

Ausgewählt – Das ausgewählte Element.

Zusätzliche Eigenschaften

AccessibleLabel – Bezeichnung des Katalogs (nicht die darin enthaltenen Elemente) für Bildschirmsprachausgaben. Sollte beschreiben, was die Liste der Elemente ist.

AllItems – Elemente, die im Katalog geladen werden. Dies kann kleiner als die tatsächliche Anzahl der Elemente der Datenquelle sein. Beim Scrollen des Katalogs werden möglicherweise weitere Elemente geladen. AllItems enthält auch Steuerelemente, die in jedem Katalogelement verwendet werden.

AllItemsCount – Anzahl der Elemente, die im Katalog geladen werden. Dies kann kleiner als die tatsächliche Anzahl der Elemente der Datenquelle sein. Beim Scrollen des Katalogs werden möglicherweise weitere Elemente geladen.

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.

DelayItemLoading – Verzögertes Laden von Elementen (Zeilen) bis nach dem ersten Laden des Bildschirms.

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

Füllung – Die Hintergrundfarbe eines Steuerelements.

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

ItemAccessibleLabel – Bezeichnung der einzelnen Katalogelemente für Bildschirmsprachausgaben. Sollte beschreiben, was jedes Element ist.

LoadingSpinner (Keine, Steuerelemente oder Daten) – Wenn keines ist, wird kein Drehfeld angezeigt. Wann Steuerelemente | Daten, Drehfeld wird angezeigt, wenn ein Renderdurchlauf auftritt, der zu sichtbaren leeren Zeilen führt.

LoadingSpinnerColor – Die Füllfarbe des Ladedrehfelds. Der Standardwert ist auf "BorderColor" festgelegt.

NavigationStep – Wie weit ein Katalog scrollt, wenn seine ShowNavigation-Eigenschaft auf "true " festgelegt ist und der Benutzer einen Navigationspfeil am Ende dieses Katalogs auswählt.

Auswählbar – Gibt an, ob Katalogelemente ausgewählt werden können. Wenn dieser Wert auf "true" festgelegt ist, identifizieren Bildschirmsprachausgaben den Katalog als auswählbare Liste. Und Sie wählen ein Element aus, indem Sie es auswählen. Wenn dieser Wert auf "false" festgelegt ist, identifizieren Bildschirmsprachausgaben den Katalog als normale Liste, und wenn Sie ein Element auswählen, wird es nicht ausgewählt.

ShowNavigation – Gibt an, ob an jedem Ende eines Katalogs ein Pfeil angezeigt wird, damit ein Benutzer durch die Elemente im Katalog scrollen kann, indem er einen Pfeil auswählt.

ShowScrollbar – Gibt an, ob eine Bildlaufleiste angezeigt wird, wenn der Benutzer auf einen Katalog zeigt.

TemplateFill – Die Hintergrundfarbe eines Katalogs.

TemplatePadding – Der Abstand zwischen Elementen in einem Katalog.

TemplateSize – Die Höhe der Vorlage für einen Katalog in vertikaler/hochformatigen Ausrichtung. Oder die Breite der Vorlage für einen Katalog in horizontaler/Querformatausrichtung. Die Mindestgröße ist eine.

Übergang – Der visuelle Effekt (Pop, Push oder None), wenn der Benutzer auf ein Element in einem Katalog zeigt.

Sichtbar – Ob ein Steuerelement angezeigt oder ausgeblendet ist.

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

WrapCount – Anzahl der pro Zeile oder Spalte angezeigten Elemente basierend auf horizontalen oder vertikalen Layouts.

X – Der Abstand zwischen dem linken Rand eines Steuerelements und dem linken Rand des übergeordneten Containers oder Bildschirms.

Y – Der Abstand zwischen dem oberen Rand eines Steuerelements und dem oberen Rand des übergeordneten Containers oder Bildschirms.

Verwandte Funktionen

Filter( Datenquelle, Formel )

Reset( Control ) – Setzt Den Katalog wieder auf den Anfangszustand zurück. Der Anfangszustand enthält einen Bildlauf zum ersten Element und das Auswählen des ersten Elements oder der Standardeinstellung, falls vorhanden.

Examples

Anzeigen und Filtern von Daten

• Text anzeigen
• Bilder anzeigen
• Filtern von Daten durch Auswählen einer Listenoption
• Filtern von Daten durch Anpassen eines Schiebereglers

Abrufen von Daten vom Benutzer

• Abrufen von Text
• Bilder abrufen
• Abrufen von Fotos
• Abrufen von Sounds
• Abrufen von Zeichnungen

Richtlinien für Eingabehilfen

Farbkontrast

Wenn Sie auf eine beliebige Stelle in einem Katalogelement klicken möchten, muss ein ausreichender Farbkontrast vorhanden sein:

• BorderColor und die Farbe außerhalb des Katalogs (wenn ein Rahmen vorhanden ist).
• Füllen Und die Farbe außerhalb des Katalogs (wenn kein Rahmen vorhanden ist).

Unterstützung für Sprachausgabe

• AccessibleLabel muss vorhanden sein.

  Hinweis

  Bildschirmsprachausgaben geben an, wann Elemente im Katalog geändert werden. Das AccessibleLabel wird ebenfalls erwähnt. Dies gibt Kontext zu der Ankündigung und ist noch wichtiger, wenn mehrere Kataloge auf demselben Bildschirm vorhanden sind.

• Wenn ein Katalogelement mehrere Steuerelemente enthält, verwenden Sie ItemAccessibleLabel , um den Inhalt von Katalogelementen anzuzeigen.

• Legen Sie den Wert von "Auswahlfähig" auf "true " fest, wenn Benutzer ein Katalogelement auswählen möchten. Legen Sie andernfalls diesen Wert auf "false" fest.

• Wenn ein Katalogelement mehrere Steuerelemente enthält, verwenden Sie ItemAccessibleLabel , um eine Zusammenfassung des Inhalts des Katalogelements bereitzustellen.

• Auswahlfähig sollte entsprechend festgelegt werden, je nachdem, ob Benutzer ein Katalogelement auswählen sollen.

Tastaturunterstützung

• Erwägen Sie das Festlegen von ShowScrollbar auf "true". Auf den meisten Touchscreengeräten wird die Bildlaufleiste erst angezeigt, wenn der Bildlauf beginnt.

• Wenn Sie auf eine beliebige Stelle in einem Katalogelement klicken, müssen Sie es auch auswählen, damit Tastaturbenutzer das Katalogelement auswählen können. Fügen Sie beispielsweise eine Schaltfläche hinzu, deren OnSelect-Eigenschaft auf Select(Parent) festgelegt ist.

  Hinweis

  Steuerelemente außerhalb des Katalogs werden nicht in der Navigationsreihenfolge der Tastatur im Katalog berücksichtigt. TabIndex-Steuerelemente in einem Katalog sind bereichsbezogene. Weitere Informationen finden Sie unter Barrierefreiheitseigenschaften .

Siehe auch

Verwenden des DelayItemLoading- und Loading-Drehfelds zur Verbesserung der Leistung im Katalog