Элемент управления Список в Power Apps

Список, в котором пользователь может выбрать один или несколько элементов.

Описание

Элемент управления Список всегда отображает все доступные варианты выбора (в отличие от элемента управления Раскрывающийся список), и в нем пользователь может выбрать несколько элементов одновременно (в отличие от элемента управления Кнопка-переключатель).

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

Default  — начальное значение элемента управления до его изменения пользователем.

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

При добавлении коллекции, списка или диаграммы список свойств по умолчанию отображает Items, чтобы можно было легко указать данные, которые должен показывать новый элемент управления. Например, можно задать в свойстве Items коллекции таблицу Account в Salesforce, таблицу Inventory, созданную в Excel и переданную в облако, или список с именем ConferenceSpeakers.

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

AccessibleLabel — метка для средств чтения с экрана.

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

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

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

Color  — цвет текста в элементе управления.

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

DisabledBorderColor — цвет границы элемента управления, если для его свойства DisplayMode установлено значение Disabled.

DisabledColor — цвет текста в элементе управления, если для его свойства DisplayMode установлено значение Disabled.

DisabledFill — цвет фона элемента управления, если для его свойства DisplayMode установлено значение Disabled.

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

FocusedBorderColor — цвет границы элемента управления в тот момент, когда он активен.

FocusedBorderThickness — толщина границы элемента управления при наведении фокуса.

Font  — имя семейства шрифтов, используемых для отображения текста.

FontWeight  — толщина текста в элементе управления: Bold (Жирный), Semibold (Полужирный), Normal (Обычный) или Lighter (Очень тонкий).

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

HoverBorderColor  — цвет границы элемента управления при наведении на него указателя мыши.

HoverColor  — цвет текста в элементе управления при наведении на него указателя мыши.

HoverFill — цвет фона элемента управления при наведении на него указателя мыши.

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

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

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

OnChange — действия, выполняемые, когда пользователь изменяет значение элемента управления (например, перемещая ползунок).

OnSelect — действия, выполняемые, когда пользователь щелкает элемент управления или касается его.

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

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

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

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

PressedBorderColor  — цвет границы элемента управления при щелчке или касании.

PressedColor  — цвет текста в элементе управления при щелчке или касании.

PressedFill  — цвет фона элемента управления при щелчке или касании.

Reset  — определяет, возвращается ли элемент управления к значению по умолчанию.

Selected — запись данных, представляющая выбранный элемент.

SelectedItems - Только для чтения. Представляет таблицу данных выбранных элементов для списка с выбором нескольких элементов.

SelectedItemsText - Только для чтения. Представляет таблицу данных текста выбранных элементов для списка с выбором нескольких элементов.

SelectedText (не рекомендуется)  — строковое значение, представляющее выбранный элемент.

SelectionColor  — цвет текста выбранного элемента или элементов списка или цвет инструмента выделения в элементе управления Ввод с помощью пера.

SelectionFill — цвет фона выбранного элемента или элементов списка или выделенной области элемента управления Ввод с помощью пера.

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

Size  — размер шрифта текста, отображаемого в элементе управления.

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

TabIndex — порядок навигации с помощью клавиатуры относительно других элементов управления.

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

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

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

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

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

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

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

Distinct( источник_данных, имя_столбца )

Пример

1. Добавьте элемент управления Список, назовите его CategoryList и укажите для свойства Items следующую формулу:
   ["Carpet","Hardwood","Tile"]

   Не знаете, как добавить, назвать и настроить элемент управления?

   

2. Добавьте три элемента управления Раскрывающийся список, переместите их под элемент CategoryList и назовите CarpetList, HardwoodList и TileList.

3. Укажите для свойства Items каждого из элементов управления Раскрывающийся список одно из следующих значений:

   • CarpetList: ["Caserta Stone Beige","Ageless Beauty Clay", "Lush II Tundra"]

   • HardwoodList: ["Golden Teak","Natural Hickory", "Victoria Mahogany"]

   • TileList: ["Honey Onyx Marble","Indian Autumn Slate", "Panaria Vitality Ceramic"]

     

4. Укажите для свойства Visible каждого из элементов управления Раскрывающийся список одно из следующих значений:

   • CarpetList: If("Carpet" in CategoryList.SelectedItems.Value, true)

   • HardwoodList: If("Hardwood" in CategoryList.SelectedItems.Value, true)

   • TileList: If("Tile" in CategoryList.SelectedItems.Value, true)

     Нуждаетесь в дополнительных сведениях о функции If или других функциях?

5. Нажмите клавишу F5 и выберите один или несколько элементов в элементе управления CategoryList.

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

   

6. (Необязательно.) Нажмите клавишу ESC, чтобы вернуться в рабочую область по умолчанию.

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

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

Необходимо настроить достаточный контраст для следующих элементов:

• SelectionColor и SelectionFill
• SelectionFill и Fill
• HoverFill и Fill
• PressedFill и Fill

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

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

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

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

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

• Индикаторы фокуса должны быть хорошо видны. Для этого используются элементы FocusedBorderColor и FocusedBorderThickness.

  Примечание

  Клавиша табуляции позволяет переходить к элементу управления Список и выходить из него. Для перехода по содержимому элемента управления Список используются клавиши со стрелками.