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

Статья
08/11/2011

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

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

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

Кнопка является объектом, с которым взаимодействует пользователь для выполнения действий, например кнопки ОК и Отменить, в диалоговых окнах. Кнопка является простым элементом управления, так как она сопоставляется с одной командой, которую пользователь хочет выполнить.

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

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

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

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

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

Представление элементов управления	Представление содержимого
Кнопка Изображение (0 или более) Text (0 или более)	Кнопка

Кнопка

Изображение (0 или более)
Text (0 или более)

Кнопка

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

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

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

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

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

Шаблон элемента управления	Поддержка	Примечания
IInvokeProvider	См. примечания.	Все кнопки должны поддерживать шаблон элемента управления Invoke или Toggle. Вызов поддерживается, когда кнопка выполняет команду по запросу пользователя. Эта команда связана в одной операцией, например "Вырезать", "Копировать", "Вставить" или "Удалить".
IToggleProvider	См. примечания.	Все кнопки должны поддерживать шаблон элемента управления Invoke или Toggle. Переключение поддерживается, если кнопка может последовательно принимать до трех состояний. Как правило, это выглядит как переключатель "включить/выключить" отдельных возможностей.
IExpandCollapseProvider	См. примечания.	Если кнопка размещена как дочерний элемент разворачивающейся кнопки, дочерняя кнопка может поддерживать шаблон ExpandCollapse вместо шаблона Invoke или Toggle. Шаблон ExpandCollapse может использоваться для открытия или закрытия меню или другой подструктуры, связанной с элементом "Кнопка".

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

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

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

См. также

Ссылки

Button

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

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

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

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