Galeriebeheer in Power Apps

Een besturingselement dat andere besturingselementen bevat en een set gegevens weergeeft.

Description

Een besturingselement Galerie kan meerdere records uit een gegevensbron weergeven en elke record kan meerdere typen gegevens bevatten. Gebruik bijvoorbeeld een besturingselement Galerie om meerdere contactpersonen weer te geven met elk item met contactgegevens met een naam, een adres en een telefoonnummer voor elke contactpersoon.

Elk gegevensveld wordt weergegeven in een afzonderlijk besturingselement in het besturingselement Galerie . En u kunt deze besturingselementen configureren in de sjabloon. De sjabloon wordt weergegeven als het eerste item in de galerie:

• Aan de linkerkant van een besturingselement Galerie in horizontale/liggende afdrukstand.
• En boven aan een galerie besturingselement in verticale/staande stand.

Alle wijzigingen die u in de sjabloon aanbrengt, worden doorgevoerd in het besturingselement Galerie .

Vooraf gedefinieerde sjablonen voor het weergeven van afbeeldingen en tekst in een galerie zijn beschikbaar en een galerie voor items met variabele hoogte.

Beperkingen

Het galeriebeheer heeft de volgende beperkingen:

1. Als een gebruiker door het besturingselement Galerie flexibele hoogte schuift voordat alle items worden geladen, kan het item dat momenteel in de weergave is, omlaag worden gepusht en niet meer zichtbaar wanneer het laden van gegevens is voltooid. Gebruik een standaard galerie besturingselement in plaats van de variant Flexibele hoogte om dit probleem te voorkomen.
2. De volgende besturingselementen worden niet ondersteund in een galerie:
   • Formulier weergeven
   • Formulier bewerken
   • PDF-viewer
   • Power BI-tegel
   • Rtf-teksteditor
   • Schuifbaar scherm (vloeistofraster)
   • Web streepjescodescanner
3. U kunt geen galerie toevoegen in een andere galerie als deze zich al in een andere galerie bevindt. Het maximale nestniveau is 2.
4. De minimale templateSize is er een. Dit kan ertoe leiden dat besturingselementen in de galerie afwijken van de verwachte X - of Y-waarden wanneer u geen rekening houdt met de sjabloongrootte.
5. Als u automatisch een app genereert op basis van gegevens, slaat u de app op en opent u deze opnieuw, worden in de bladergalerie mogelijk niet onmiddellijk gegevens weergegeven. Als u dit probleem wilt oplossen, typt u ten minste één teken in het zoekvak en verwijdert u de tekst die u hebt getypt. De galerie toont vervolgens de gegevens zoals verwacht.
6. Als een galerie een besturingselement ComboBox, DatePicker, Slider of Toggle bevat met een OnChange regel die dezelfde gegevensbron of verzameling als de galerie patcht, kan dit leiden tot onverwachte of verminderde prestaties. Dit komt doordat een OnChange regel die de gegevensbron van de galerie patcht, een oneindige cyclus van patchen en opnieuw laden kan maken. Om dit probleem te voorkomen, is het raadzaam geen regels te gebruiken OnChange wanneer deze besturingselementen in een galerie worden geplaatst.

Belangrijke eigenschappen

Standaard : het item of de record uit de gegevensbron die moet worden geselecteerd in de galerie wanneer de app wordt gestart.

Items : de gegevensbron die wordt weergegeven in een besturingselement, zoals een galerie, een lijst of een grafiek.

Geselecteerd : het geselecteerde item.

Aanvullende eigenschappen

AccessibleLabel – Label van de galerie (niet de items die het bevat) voor schermlezers. Moet beschrijven wat de lijst met items is.

AllItems : items die in de galerie worden geladen. Dit kan kleiner zijn dan het werkelijke aantal items van de gegevensbron. Er kunnen meer items worden geladen wanneer de galerie wordt gescrold. AllItems bevat ook besturingselementen die in elk galerie-item worden gebruikt.

AllItemsCount - Aantal items dat in de galerie wordt geladen. Dit kan kleiner zijn dan het werkelijke aantal items van de gegevensbron. Er kunnen meer items worden geladen wanneer de galerie wordt gescrold.

BorderColor : de kleur van de rand van een besturingselement.

BorderStyle : of de rand van een besturingselement effen, onderbroken, gestippeld of Geen is.

BorderThickness : de dikte van de rand van een besturingselement.

DelayItemLoading : het laden van items (rijen) vertragen totdat het scherm voor het eerst is geladen.

DisplayMode : of het besturingselement gebruikersinvoer toestaat (bewerken), alleen gegevens weergeeft (weergave) of is uitgeschakeld (uitgeschakeld).

Opvulling : de achtergrondkleur van een besturingselement.

Hoogte : de afstand tussen de boven- en onderrand van een besturingselement.

ItemAccessibleLabel – Label van elk galerie-item voor schermlezers. Moet beschrijven wat elk item is.

LoadingSpinner (Geen, Besturingselementen of Gegevens): wanneer geen, wordt de spinner niet weergegeven. Wanneer besturingselementen | Gegevens, kringveld wordt weergegeven wanneer er een render-pass optreedt die resulteert in zichtbare lege rijen.

LoadingSpinnerColor - De opvulkleur van de laadspinner. De standaardwaarde is ingesteld op BorderColor.

NavigationStep : hoe ver een galerie schuift als de eigenschap ShowNavigation is ingesteld op Waar en de gebruiker een navigatiepijl aan een van beide uiteinden van die galerie selecteert.

Selecteerbaar : of galerie-items kunnen worden geselecteerd. Als deze optie is ingesteld op waar, identificeren schermlezers de galerie als een selecteerbare lijst. En u selecteert een item door het te selecteren. Als deze optie is ingesteld op onwaar, identificeren schermlezers de galerie als een gewone lijst en wordt het item niet geselecteerd.

ShowNavigation : of een pijl aan elk uiteinde van een galerie wordt weergegeven, zodat een gebruiker door de items in de galerie kan schuiven door een pijl te selecteren.

ShowScrollbar : of er een schuifbalk wordt weergegeven wanneer de gebruiker de muisaanwijzer boven een galerie beweegt.

TemplateFill : de achtergrondkleur van een galerie.

TemplatePadding : de afstand tussen items in een galerie.

TemplateSize : de hoogte van de sjabloon voor een galerie in verticale/staande stand. Of de breedte van de sjabloon voor een galerie in horizontale/liggende afdrukstand. De minimale grootte is één.

Overgang : het visuele effect (Pop, Push of Geen) wanneer de gebruiker een item in een galerie aanwijst.

Zichtbaar : of een besturingselement wordt weergegeven of verborgen is.

Breedte : de afstand tussen de linker- en rechterrand van een besturingselement.

WrapCount : het aantal items dat per rij of kolom wordt weergegeven op basis van horizontale of verticale indeling.

X : de afstand tussen de linkerrand van een besturingselement en de linkerrand van de bovenliggende container of het bovenliggende scherm.

Y : de afstand tussen de bovenrand van een besturingselement en de bovenrand van de bovenliggende container of het bovenliggende scherm.

Gerelateerde functies

Filter( DataSource, Formule )

Reset( Control ) - Hiermee wordt de oorspronkelijke status van de galerie hersteld. De initiële status omvat het schuiven naar het eerste item en het selecteren van het eerste item of de standaardinstelling als deze aanwezig is.

Voorbeelden

Gegevens weergeven en filteren

• Tekst weergeven
• Afbeeldingen weergeven
• Gegevens filteren door een lijstoptie te selecteren
• Gegevens filteren door een schuifregelaar aan te passen

Gegevens ophalen van de gebruiker

• Tekst ophalen
• Afbeeldingen ophalen
• Foto's ophalen
• Geluiden ophalen
• Tekeningen ophalen

Toegankelijkheidsrichtlijnen

Kleurcontrast

Als u ergens in een galerie-item klikt om het te selecteren, moet er voldoende kleurcontrast zijn tussen:

• BorderColor en de kleur buiten de galerie (als er een rand is).
• Opvulling en de kleur buiten de galerie (als er geen rand is).

Ondersteuning voor schermlezer

• AccessibleLabel moet aanwezig zijn.

  Opmerking

  Schermlezers kondigen aan wanneer items in de galerie worden gewijzigd. Het AccessibleLabel wordt ook genoemd. Dit geeft context aan de aankondiging en is nog belangrijker wanneer er meerdere galerieën op hetzelfde scherm staan.

• Wanneer een galerie-item meerdere besturingselementen bevat, gebruikt u ItemAccessibleLabel om de inhoud van galerie-items weer te geven.

• Stel de waarde van Selectable in op True als u wilt dat gebruikers een galerie-item selecteren. Anders stelt u die waarde in op onwaar.

• Wanneer een galerie-item meerdere besturingselementen bevat, gebruikt u ItemAccessibleLabel om een samenvatting te geven van de inhoud van het galerie-item.

• Selecteerbaar moet op de juiste manier worden ingesteld, afhankelijk van of gebruikers een galerie-item moeten selecteren.

Toetsenbordondersteuning

• Overweeg om ShowScrollbar in te stellen op true. Op de meeste apparaten met aanraakscherm wordt de schuifbalk pas weergegeven als het schuiven begint.

• Als u ergens in een galerie-item klikt om het te selecteren, moet er ook een manier zijn voor toetsenbordgebruikers om het galerie-item te selecteren. Als u bijvoorbeeld een knop toevoegt waarvoor de eigenschap OnSelect is ingesteld op Selecteren (bovenliggend)

  Opmerking

  Besturingselementen buiten de galerie worden niet in de toetsenbordnavigatievolgorde in de galerie beschouwd. TabIndex-besturingselementen in een galerie zijn gericht. Zie toegankelijkheidseigenschappen voor meer informatie.

Zie ook

DelayItemLoading en Load spinner gebruiken om de prestaties in galerie te verbeteren