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

Тип элемента управления ListItem

  • Статья

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

Элементы управления списком — это пример элементов управления, реализующих тип элемента управления ListItem.

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

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

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

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

Представление элемента управления Представление содержимого
  • ListItem
    • Изображение (0 или более)
    • Текст (0 или более)
    • Изменение (0 или более)
  • ListItem

 

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

Соответствующие свойства

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

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

 

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

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

Шаблон элемента управления Поддержка Примечания
IExpandCollapseProvider Зависит Если элемент можно управлять отображением или скрытием информации, необходимо реализовать шаблон элемента управления ExpandCollapse.
IGridItemProvider Зависит Если в контейнере списка поддерживается пространственная навигация по элементам, а контейнер упорядочивается в строках и столбцах, необходимо реализовать шаблон элемента управления GridItem.
IInvokeProvider Зависит Если элемент имеет команду, которую можно выполнить, отдельно от выделения, необходимо реализовать шаблон элемента управления Invoke. Обычно это действие, связанное с двойным щелчком элемента управления элементом списка. Примеры — запуск документа из проводника Windows или воспроизведение музыкального файла в Проигрывателе Microsoft Windows Media.
IScrollItemProvider Зависит Если элемент списка содержится в контейнере с возможностью прокрутки, необходимо реализовать шаблон управления ScrollItem.
ISelectionItemProvider Зависит Элемент управления элементом списка, поддерживающий выбор, должен реализовать шаблон элемента управления SelectionItem SelectionItem. Это позволяет элементам управления списком передавать данные при их выборе.
IToggleProvider Зависит Если элемент списка можно проверить, и действие не выполняет изменение состояния выбора, необходимо реализовать переключение шаблона элемента управления.
IValueProvider Зависит Если элемент можно изменить, необходимо реализовать шаблон элемента управления значения. Изменения элемента управления элементом списка вызывают изменения значений UIA_NamePropertyId и UIA_ValueValuePropertyId свойств.

 

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

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

Событие автоматизации пользовательского интерфейса Примечания
UIA_AutomationFocusChangedEventId
событие UIA_BoundingRectanglePropertyId изменено свойством.
UIA_ExpandCollapseExpandCollapseStatePropertyId событие изменения свойства. Если элемент управления поддерживает шаблон элемента управления ExpandCollapse, он должен поддерживать это событие.
UIA_Invoke_InvokedEventId Если элемент управления поддерживает шаблон элемента управления Invoke, он должен поддерживать это событие.
событие UIA_IsEnabledPropertyId изменено свойством. Если элемент управления поддерживает свойство IsEnabled, он должен поддерживать это событие.
событие UIA_IsOffscreenPropertyId изменено свойством. Если элемент управления поддерживает свойство IsOffscreen, он должен поддерживать это событие.
UIA_ItemStatusPropertyId событие изменения свойства. Если элемент управления поддерживает свойство ItemStatus, он должен поддерживать это событие.
событие UIA_NamePropertyId изменено свойством.
UIA_SelectionItem_ElementAddedToSelectionEventId Если элемент управления поддерживает шаблон SelectionItem, он должен поддерживать это событие.
UIA_SelectionItem_ElementRemovedFromSelectionEventId Если элемент управления поддерживает шаблон SelectionItem, он должен поддерживать это событие.
UIA_SelectionItem_ElementSelectedEventId Если элемент управления поддерживает шаблон SelectionItem, он должен поддерживать это событие.
UIA_StructureChangedEventId
UIA_ToggleToggleStatePropertyId событие, измененное свойством. Если элемент управления поддерживает шаблон переключателя, он должен поддерживать это событие.
UIA_ValueValuePropertyId событие изменения свойства. Если элемент управления поддерживает шаблон Value, он должен поддерживать это событие.

 

Замечания

Если в контейнере размещаются элементы списка, основное средство навигации должно перейти к элементам списка. Размещение фокуса на подэлементах с помощью навигации по списку может быть запутано для пользователей и средств специальных возможностей. Если контейнер содержит вертикальный список элементов, нажимая клавиши СТРЕЛКА ВВЕРХ и СТРЕЛКА ВНИЗ, должны перемещаться по элементам, но нажатие клавиш СТРЕЛКА ВПРАВО и СТРЕЛКА ВЛЕВО может переходить к подэлементам фокуса, таким как столбцы списка или подэлементы пользовательского интерфейса.

концептуальные

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

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