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

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

Замечание

Эта документация предназначена для разработчиков .NET Framework, которые хотят использовать управляемые классы автоматизации пользовательского интерфейса, определенные в пространстве имен System.Windows.Automation. Последние сведения об автоматизации пользовательского интерфейса см. в разделе API автоматизации Windows: автоматизация пользовательского интерфейса.

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

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

В следующих разделах определяется необходимая структура дерева автоматизации пользовательского интерфейса, свойства, шаблоны элементов управления и события для типа элемента управления ComboBox. Требования к автоматизации пользовательского интерфейса применяются ко всем элементам управления со списком, будь то Windows Presentation Foundation (WPF), Win32 или Windows Forms.

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

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

Вид управления Просмотр содержимого
ComboBox

— Изменить (0 или 1)
— Список (1)
— Элемент списка (дочерний элемент списка; от 0 и более)
- Кнопка (1)		 ComboBox

— Элемент списка (от 0 и более)

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

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

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

Свойство автоматизации пользовательского интерфейса Ценность Примечания.
AutomationIdProperty См. заметки. Значение этого свойства должно быть уникальным для всех элементов управления в приложении.
BoundingRectangleProperty См. заметки. Самый внешний прямоугольник, содержащий весь элемент управления.
ClickablePointProperty См. заметки. Поддерживается, если существует ограничивающий прямоугольник. Если не на каждую точку в ограничивающем прямоугольнике можно щелкнуть, и вы проводите специализированную проверку на попадание, то переопределите и укажите точку, на которую можно щелкнуть.
ControlTypeProperty ComboBox Это значение одинаково для всех платформ пользовательского интерфейса.
HelpTextProperty См. заметки. Текст справки для элементов управления комбинированным полем должен пояснять, почему пользователю нужно выбрать вариант из данного поля. Текст похож на информацию, представленную подсказкой. Например, "Выберите элемент, чтобы задать разрешение дисплея монитора".
IsContentElementProperty Верно Элементы управления полем со списком всегда включаются в представление содержимого дерева автоматизации пользовательского интерфейса.
IsControlElementProperty Верно Элементы управления полем со списком всегда включаются в представление элемента управления дерева автоматизации пользовательского интерфейса.
IsKeyboardFocusableProperty Верно Компоненты управления комбинированным списком предоставляют набор элементов из контейнера выбора. Элемент управления комбинированным списком может получать фокус клавиатуры, хотя если клиент автоматизации пользовательского интерфейса задает фокус на комбинированный список, любые элементы в поддереве комбинированного списка могут получить фокус.
LabeledByProperty См. заметки. Элементы управления со списком обычно имеют статическую текстовую метку, на которую ссылается это свойство.
LocalizedControlTypeProperty Комбинированный список Локализованная строка, соответствующая типу элемента управления ComboBox.
NameProperty См. заметки. Элемент управления комбинированным списком обычно получает имя из статического элемента управления текстом.

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

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

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

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

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

Событие автоматизации пользовательского интерфейса Поддержка Примечания.
AutomationFocusChangedEvent Обязательно Отсутствует
BoundingRectangleProperty событие изменения свойства. Обязательно Отсутствует
IsOffscreenProperty событие изменения свойства. Обязательно Отсутствует
IsEnabledProperty событие изменения свойства. Обязательно Отсутствует
StructureChangedEvent Обязательно Отсутствует
ExpandCollapseStateProperty событие изменения свойства. Обязательно Отсутствует
ValueProperty событие изменения свойства. Зависит Если элемент управления поддерживает шаблон "Значение", то он также должен поддерживать это событие.

См. также