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

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

  • Статья

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

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

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

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

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

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

Представление элемента управления Представление содержимого
  • ComboBox
    • Изменение (0 или 1)
    • Список (0 или 1)
    • Элемент списка (дочерний элемент списка; от 0 до многих)
    • Кнопка (1)
  • ComboBox
    • Элемент списка (от 0 до многих)

 

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

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

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

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

 

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

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

Шаблон элемента управления Поддержка Примечания
IExpandCollapseProvider Обязательно Шаблон элемента управления ExpandCollapse должен поддерживаться, так как элемент управления со списком всегда должен содержать кнопку раскрывающегося списка.
ISelectionProvider Зависит Отображает текущий выбор в поле со списком. Поддержка шаблона выбора делегируется в поле списка под полем со списком, но не всегда может быть возможным.
IValueProvider Зависит Если поле со списком может принимать произвольные текстовые значения, необходимо поддерживать шаблон значения. Этот шаблон позволяет программно задать строковое содержимое поля со списком. Если шаблон элемента управления значением не поддерживается, пользователь должен выбрать элементы списка в поддереве поля со списком.
IScrollProvider Никогда Шаблон элемента управления прокрутки никогда не поддерживается непосредственно в поле со списком. Он поддерживается, если поле списка, содержащееся в поле со списком, может прокручиваться, и только если поле списка отображается на экране.

 

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

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

Событие автоматизации пользовательского интерфейса Примечания
UIA_AutomationFocusChangedEventId
событие UIA_BoundingRectanglePropertyId изменено свойством.
событие UIA_IsEnabledPropertyId изменено свойством. Если элемент управления поддерживает свойство IsEnabled, он должен поддерживать это событие.
событие UIA_IsOffscreenPropertyId изменено свойством. Если элемент управления поддерживает свойство IsOffscreen, он должен поддерживать это событие.
UIA_StructureChangedEventId
UIA_ExpandCollapseExpandCollapseStatePropertyId событие изменения свойства.
UIA_ValueValuePropertyId событие изменения свойства. Если элемент управления поддерживает шаблон Value, он должен поддерживать это событие.

 

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

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

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