Поделиться через

Тип элемента управления "Список"

  • Статья

В этом разделе содержатся сведения о поддержке microsoft модель автоматизации пользовательского интерфейса для типа элемента управления List.

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

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

В этом разделе содержатся следующие подразделы.

Типичная древовидная структура

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

Представление элемента управления Представление содержимого
Содержит элементы, соответствующие элементам управления. Удаляет избыточные сведения из дерева, чтобы вспомогательные технологии работали с наименьшим набором сведений, значимых для конечного пользователя.
  • Список
    • DataItem (0 или более)
    • ListItem (0 или более)
    • Group (0 или более)
    • ScrollBar (0, 1 или 2)
  • Список
    • DataItem (0 или более)
    • ListItem (0 или более)
    • Group (0 или более)

Представление для элемента управления, который реализует тип List (например, элемент управления "Список"), включает следующие элементы:

  • Ноль или несколько элементов в элементе управления списком (элементы могут быть основаны на типах элементов управления ListItem или DataItem )
  • ноль или более элементов управления "Группа" в элементе управления "Список";
  • ноль, один или два элемента управления "Полоса прокрутки".

Представление содержимого элемента управления, который реализует тип List (например, элемент управления "Список"), включает следующие элементы:

  • Ноль или несколько элементов в элементе управления списком (элементы могут быть основаны на типах элементов управления ListItem или DataItem )
  • ноль или более групп в элементе управления "Список".

Элемент управления "Список" не должен содержать элементы, которые имеют какую-либо иерархическую связь кроме общей группы. Если элементы имеют дочерние элементы в дереве модель автоматизации пользовательского интерфейса, контейнер списка должен основываться на типе элемента управления Tree.

Доступные для выбора элементы в элементе управления списком будут доступны из потомков в дереве модель автоматизации пользовательского интерфейса элемента управления списком. Все элементы в элементе управления "Список" должны принадлежать одной группе выбора. Доступные для выбора элементы в списке должны быть представлены как типы элементов управления ListItem (вместо DataItem).

Релевантные свойства

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

Свойство модели автоматизации пользовательского интерфейса Значение Примечания
UIA_AutomationIdPropertyId См. примечания. Значение этого свойства должно быть уникальным среди всех одноранговых элементов в необработанном представлении дерева модель автоматизации пользовательского интерфейса.
UIA_BoundingRectanglePropertyId См. примечания. Внешний прямоугольник, содержащий весь элемент управления.
UIA_ClickablePointPropertyId См. примечания. Если элемент управления списком имеет точку, доступную для щелчка (точку, которую можно щелкнуть, чтобы сделать фокус списка), эту точку необходимо предоставить с помощью этого свойства. Если свойство UIA_IsOffscreenPropertyId имеет значение TRUE, попытка получить это свойство приводит к ошибке UIA_E_NOCLICKABLEPOINT .
UIA_ControlTypePropertyId Список
UIA_HelpTextPropertyId См. примечания. Текст справки для элементов управления "Список" должен объяснять, почему пользователю предлагается сделать выбор из списка параметров. Например, "Выбор элемента из этого списка установит разрешение экрана для монитора".
UIA_IsContentElementPropertyId TRUE Элемент управления "Список" всегда включается в представление содержимого дерева модель автоматизации пользовательского интерфейса.
UIA_IsControlElementPropertyId TRUE Элемент управления "Список" всегда включается в представление элемента управления дерева модель автоматизации пользовательского интерфейса.
UIA_IsKeyboardFocusablePropertyId См. примечания. Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство.
UIA_LabeledByPropertyId См. примечания. Если имеется статическая текстовая метка, то данное свойство должно предоставлять ссылку на этот элемент управления.
UIA_LocalizedControlTypePropertyId См. примечания. Локализованная строка, соответствующая типу элемента управления List . Значение по умолчанию — list для en-US или english (США).
UIA_NamePropertyId См. примечания. Значение свойства Name элемента управления списком должно передавать категорию параметров, которые пользователю предлагается выбрать. Обычно это свойство получает имя из статической текстовой метки. Если нет статической текстовой метки, разработчик приложения должен предоставить значение для свойства Name .
Единственный случай, когда данное свойство не является обязательным для элементов управления "Список", — если этот элемент управления используется в поддереве другого элемента управления.

Обязательные шаблоны и свойства элементов управления

В следующей таблице перечислены шаблоны элементов управления модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления списками. Дополнительные сведения о шаблонах элементов управления см. в разделе UI Automation Control Patterns Overview.

Шаблон элемента управления/свойство шаблона Поддержка/значение Примечания
IGridProvider Зависит Реализуйте шаблон элемента управления Сетка , если навигация по сетке должна быть доступна для каждого элемента.
IMultipleViewProvider Зависит Реализуйте шаблон элемента управления MultipleView , если элемент управления может поддерживать несколько представлений элементов в контейнере.
IScrollProvider Зависит Реализуйте шаблон элемента управления Прокрутка , если элементы в контейнере являются прокручиваемыми.
ISelectionProvider Зависит Если элемент управления поддерживает тип элемента управления List, поддерживающий выбор, элемент управления должен реализовывать шаблон элемента управления Selection , если между элементами, содержащимися в элементе управления, сохраняется состояние выделения. Если элементы в элементе управления недоступны для выбора, можно использовать тип элемента управления Group .
CanSelectMultiple Зависит Элементы управления "Список" могут быть контейнерами, разрешающими выбор одного или нескольких элементов.
IsSelectionRequired Зависит Элементы управления "Список" не всегда требуют, чтобы элемент был выбран.
ITableProvider Никогда Шаблон элемента управления Таблица никогда не поддерживается для типа элемента управления List . Если элемент управления должен поддерживать этот шаблон элемента управления, он должен основываться на типе элемента управления DataGrid .

Обязательные события

В следующей таблице перечислены события модель автоматизации пользовательского интерфейса, которые требуются для поддержки элементов управления списками. Дополнительные сведения о событиях см. в разделе UI Automation Events Overview.

Событие модель автоматизации пользовательского интерфейса Примечания
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId событие изменения свойства.
UIA_IsEnabledPropertyId событие изменения свойства. Если элемент управления поддерживает свойство IsEnabled , он должен поддерживать это событие.
UIA_IsOffscreenPropertyId событие изменения свойства. Если элемент управления поддерживает свойство IsOffscreen , он должен поддерживать это событие.
UIA_LayoutInvalidatedEventId Если макет дочерних элементов можно изменить, элемент управления должен поддерживать это событие.
UIA_MultipleViewCurrentViewPropertyId событие изменения свойства. Если элемент управления поддерживает шаблон элемента управления MultipleView , он должен поддерживать это событие.
UIA_ScrollHorizontallyScrollablePropertyId событие изменения свойства. Если элемент управления поддерживает шаблон элемента управления Scroll , он должен поддерживать это событие.
UIA_ScrollHorizontalScrollPercentPropertyId событие изменения свойства. Если элемент управления поддерживает шаблон элемента управления Scroll , он должен поддерживать это событие.
UIA_ScrollHorizontalViewSizePropertyId событие изменения свойства. Если элемент управления поддерживает шаблон элемента управления Scroll , он должен поддерживать это событие.
UIA_ScrollVerticalScrollPercentPropertyId событие изменения свойства. Если элемент управления поддерживает шаблон элемента управления Scroll , он должен поддерживать это событие.
UIA_ScrollVerticallyScrollablePropertyId событие изменения свойства. Если элемент управления поддерживает шаблон элемента управления Scroll , он должен поддерживать это событие.
UIA_ScrollVerticalViewSizePropertyId событие изменения свойства. Если элемент управления поддерживает шаблон элемента управления Scroll , он должен поддерживать это событие.
UIA_Selection_InvalidatedEventId Если элемент управления поддерживает шаблон элемента управления Selection , он должен поддерживать это событие.
UIA_StructureChangedEventId

Основные понятия

Общие сведения о типах элементов управления автоматизации пользовательского интерфейса

Общие сведения о модели автоматизации пользовательского интерфейса