Поддержка модели автоматизации пользовательского интерфейса для типа элемента управления 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 | См. примечания. | Элемент управления "Поле со списком" обычно получает свое имя из элемента управления "Статический текст". |
Необходимые шаблоны элементов управления модели автоматизации пользовательского интерфейса
В следующей таблице перечислены шаблоны элементов управления модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления со списком. Дополнительные сведения о шаблонах элементов управления см. в разделе UI Automation Control Patterns Overview.
| Шаблон элемента управления | Поддержка | Примечания. |
|---|---|---|
| IExpandCollapseProvider | Да | Элемент управления "Поле со списком" всегда должен содержать кнопку раскрывающегося списка, чтобы быть полем со списком. |
| ISelectionProvider | Да | Отображает текущий выбор в поле со списком. Эта поддержка делегируется списку под полем со списком. |
| IValueProvider | Зависит | Если поле со списком имеет возможность принимать произвольные текстовые значения, должен поддерживаться шаблон Value. Этот шаблон предоставляет возможность программно задавать содержимое строки поля со списком. Если шаблон Value не поддерживается, это означает, что пользователь должен выбирать из элементов списка в поддереве поля со списком. |
| IScrollProvider | Никогда | Шаблон Scroll никогда не поддерживается в поле со списком напрямую. Он поддерживается, если можно прокручивать список, содержащийся в поле со списком. Он может поддерживаться только тогда, когда список отображается на экране. |
Обязательные события
В следующей таблице перечислены события модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления со списком. Дополнительные сведения о событиях см. в разделе UI Automation Events Overview.
| событие модель автоматизации пользовательского интерфейса | Поддержка | Примечания. |
|---|---|---|
| AutomationFocusChangedEvent | Обязательное поле | нет |
| Событие изменения свойстваBoundingRectangleProperty | Обязательное поле | нет |
| Событие изменения свойстваIsOffscreenProperty | Обязательное поле | нет |
| Событие изменения свойстваIsEnabledProperty | Обязательное поле | нет |
| StructureChangedEvent | Обязательное поле | нет |
| Событие изменения свойстваExpandCollapseStateProperty | Обязательное поле | нет |
| Событие изменения свойстваValueProperty | Зависит | Если элемент управления поддерживает шаблон Value, то он должен поддерживать данное событие. |