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

  • Статья

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

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

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

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

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

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

Представление элемента управления Представление содержимого
  • ComboBox
    • Edit (0 или 1)
    • Список (0 или 1)
    • List Item (дочерний для List; 0 или более)
    • Button (1)
  • ComboBox
    • List Item (0 или более)

 

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

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

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

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

 

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

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

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

 

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

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

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

 

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

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

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