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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Событие UI Automation	Поддержка	Примечания
AutomationFocusChangedEvent	Обязательно	Нет
Событие, изменяемое свойством BoundingRectangleProperty.	Обязательно	Нет
Событие, изменяемое свойством IsOffscreenProperty.	Требуется	Нет
Событие, изменяемое свойством IsEnabledProperty.	Обязательно	Нет
StructureChangedEvent	Обязательно	Нет
Событие, изменяемое свойством ExpandCollapseStateProperty.	Обязательно	Нет
Событие, изменяемое свойством ValueProperty.	Зависит от конкретного случая	Это событие поддерживается в том случае, если элемент управления поддерживает шаблон Value.

См. также

Ссылки

ComboBox

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

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

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