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

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

Замечание

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

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

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

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

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

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

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

— Изображение (0 или более)
- Текст (0 или более)		 Кнопка

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

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

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

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

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

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

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

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

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

См. также