Элемент управления Gallery в приложениях на основе холста

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

Описание

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

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

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

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

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

Ограничения

Если пользователь прокручивает коллекцию Изменяющаяся высота перед загрузкой всех элементов, элемент, который в данный момент виден, может быть перемещен вниз и не виден после завершения загрузки данных. Чтобы избежать этой проблемы, используйте стандартный элемент управления Gallery вместо варианта Изменяющаяся высота.

Основные свойства

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

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

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

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

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

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

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 ) — сброс коллекции в исходное состояние. Начальное состояние включает прокрутку до первого элемента и выбор первого элемента или значения по умолчанию, если оно присутствует.

Примечание

Элемент управления Reset не выполняет рекурсивный сброс всех дочерних элементов коллекции.

Примеры

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

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

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

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

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

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

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

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

    Примечание

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

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

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

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

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

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

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

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

    Примечание

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

См. также

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