Элемент управления Галерея в Power Apps

Элемент управления, содержащий другие элементы управления и отображающий набор данных.

Описание

В элементе управления Галерея может отображаться несколько записей из источника данных, и каждая запись может содержать несколько типов данных. Например, используйте элемент управления Галерея для отображения нескольких контактов, включая имя, адрес и номер телефона для каждого из них.

Каждое поле данных отображается в отдельном элементе управления в элементе управления Галерея. И вы можете настроить эти элементы управления в ее шаблоне. Шаблон появляется как первый элемент внутри коллекции:

• На левом краю элемента управления Галерея в горизонтальной/альбомной ориентации.
• И в верху элемента управления Галерея в вертикальной/портретной ориентации.

Все внесенные в шаблон изменения отражаются во всем элементе управления Галерея.

Доступны готовые шаблоны для отображения изображений и текста в коллекции, и коллекция с элементами переменной высоты.

Ограничения

Элемент управления «Коллекция» имеет следующие ограничения:

1. Если пользователь прокручивает коллекцию Изменяющаяся высота перед загрузкой всех элементов, элемент, который в данный момент виден, может быть перемещен вниз и не виден после завершения загрузки данных. Чтобы избежать этой проблемы, используйте стандартный элемент управления Галерея вместо варианта Изменяющаяся высота.
2. Следующие элементы управления не поддерживаются в коллекции:
   • Форма отображения
   • Форма изменения
   • Средство просмотра PDF-файлов
   • Элемент Power BI
   • Редактор форматированного текста
   • Прокручиваемый экран (жидкая сетка)
   • Веб-сканер штрихкодов
3. Вы можете добавить только одну коллекцию внутри другой.
4. Минимальное значение TemplateSize — единица. Это может привести к тому, что элементы управления в Галерея будут отклоняться от своих ожидаемых значений X и Y, если не учитывать размер шаблона.
5. Если вы автоматически создадите приложение на основе данных, сохраните приложение, а затем снова откроете его, данные в обзоре коллекции могут отобразиться не сразу. Чтобы устранить эту проблему, в поле поиска введите по крайней мере один символ, а затем удалите введенный текст. Данные в коллекции отобразятся, как ожидалось.

Ключевые свойства

Default — элемент или запись из источника данных, выбираемые в коллекции при запуске приложения.

Items — источник данных, отображаемых в элементе управления, такой как коллекция, список или диаграмма.

Selected — выбранный элемент.

Дополнительные свойства

AccessibleLabel — подпись коллекции (не элементов, которые она содержит) для программ чтения с экрана. Должна описывать список элементов.

AllItems — элементы, загружаемые в коллекцию. Это число может быть меньше фактического количества элементов в источнике данных (Items). По мере прокрутки коллекции могут загружаться дополнительные элементы. AllItems также содержит элементы управления, используемые в каждом элементе коллекции.

AllItemsCount — количество элементов, загружаемых в коллекцию. Это число может быть меньше фактического количества элементов в источнике данных (Items). По мере прокрутки коллекции могут загружаться дополнительные элементы.

BorderColor — цвет границы элемента управления.

BorderStyle — стиль границы элемента управления: Solid, Dashed, Dotted или None.

BorderThickness — толщина границы элемента управления.

DelayItemLoading — задержка загрузки элементов (строк) до первой загрузки экрана.

DisplayMode — в зависимости от значения этого режима элемент управления разрешает пользователю вводить данные (Изменение), только отображает данные (Просмотр) или элемент вообще отключен (Отключено).

Fill — цвет фона элемента управления.

Height — расстояние между верхним и нижним краями элемента управления.

ItemAccessibleLabel — подпись каждого элемента коллекции для программ чтения с экрана. Должна описывать, что представляет собой каждый элемент.

LoadingSpinner (None, Controls илиor Data) — если задано значение None, вертушка не отображается. Когда Controls или Data, будет отображаться вертушка, когда выполняется проход отрисовщика, который приводит к видимым пустым строкам.

LoadingSpinnerColor — цвет заливки загрузочной вертушки. По умолчанию установлено значение BorderColor.

NavigationStep — определяет шаг прокрутки коллекции, если ее свойству ShowNavigation присвоено значение true и пользователь выбрал стрелку навигации на любом конце этой коллекции.

Selectable — можно ли выбрать элементы галереи. Когда установлено значение true, программы чтения с экрана идентифицируют коллекцию как выбираемый список. И вы выбираете элемент, выбирая его. Когда установлено значение false, программы чтения с экрана идентифицируют коллекцию как обычный список, а при выборе элемента он не выбирается.

ShowNavigation — определяет появление стрелки на каждом конце коллекции, с помощью которой пользователь сможет прокручивать элементы, выбирая стрелки.

ShowScrollbar — определяет появление полосы прокрутки при наведении пользователем указателя на коллекцию.

TemplateFill — цвет фона коллекции.

TemplatePadding — расстояние между элементами в коллекции.

TemplateSize — высота шаблона для коллекции в вертикальной/портретной ориентации. Или ширина шаблона для коллекции в горизонтальной/альбомной ориентации. Минимальный размер — единица.

Transition — визуальный эффект (Pop, Push или None) при наведении пользователем указателя на элемент коллекции.

Visible — определяет, отображается элемент управления или он скрыт.

Width — расстояние между левым и правым краями элемента управления.

WrapCount — количество отображаемых элементов в строке (горизонтальный макет) или столбце (вертикальный макет).

X — расстояние между левым краем элемента управления и левым краем его родительского контейнера или экрана.

Y — расстояние между верхним краем элемента управления и верхним краем его родительского контейнера или экрана.

Связанные функции

Filter( DataSource, Formula )

Reset( Control ) — сброс коллекции в исходное состояние. Начальное состояние включает прокрутку до первого элемента и выбор первого элемента или значения по умолчанию, если оно присутствует.

Примеры

Отображение и фильтрация данных

• Отображение текста
• Отображение изображений
• Фильтрация данных с помощью выбора элемента списка
• Фильтрация данных с помощью ползунка

Получение данных от пользователя

• Получение текста
• Получение изображений
• Получение фотографий
• Получение звуков
• Получение рисунков

Руководство по настройке специальных возможностей

Контрастность цветов

Так как при щелчке в любом месте элемента коллекции должен происходить его выбор, следует установить достаточную контрастность между следующими элементами:

• BorderColor и цветом за пределами коллекции (если есть граница).
• Fill и цвет за пределами коллекции (если нет границы).

Поддержка средства чтения с экрана

• Должен присутствовать элемент AccessibleLabel.

  Примечание

  Средства чтения с экрана проинформируют об изменениях в коллекции. AccessibleLabel также упоминается. Так обеспечивается контекст оповещения. Это еще важнее при наличии нескольких коллекций на экране.

• Если элемент коллекции содержит несколько элементов управления, используйте ItemAccessibleLabel, чтобы показать содержимое элементов коллекции.

• Установите значение свойства Selectable равным true, если хотите, чтобы пользователи выбирали элемент коллекции. В противном случае установите это значение на false.

• Если элемент коллекции содержит несколько элементов управления, используйте ItemAccessibleLabel, чтобы предоставить сводку содержимого элемента коллекции.

• Свойство Selectable должно быть установлено соответствующим образом, в зависимости от того, нужно ли разрешить пользователям выбрать элемент коллекции.

Поддержка клавиатуры

• Установите для параметра ShowScrollbar значение true. На большинстве устройств с сенсорным экраном полоса прокрутки не отображается, пока не начнется прокрутка.

• Так как при щелчке в любом месте элемента коллекции должен происходить его выбор, поэтому для клавиатуры также должны быть предусмотрены аналогичные действия. Например, можно добавить элемент управления Кнопка, для свойства OnSelect которого задано значение Select(Parent).

  Примечание

  Элементы управления вне коллекции не учитываются в порядке навигации с клавиатуры внутри коллекции. Элементы управления с TabIndex внутри коллекции находятся в области. Дополнительные сведения см. в разделе свойств специальных возможностей.

См. также

Используйте счетчик DelayItemLoading и LoadingSpinner для повышения производительности в коллекции