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

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

Замечание

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

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

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

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

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

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

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

Замечание

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

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

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

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

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

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

Шаблон элемента управления Поддержка Примечания.
IToggleProvider Обязательно Позволяет флажку циклически проходить через внутренние состояния программным способом.

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

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

Событие автоматизации пользовательского интерфейса Поддержка Примечания.
AutomationFocusChangedEvent Обязательно Отсутствует
BoundingRectangleProperty событие изменения свойства. Обязательно Отсутствует
IsOffscreenProperty событие изменения свойства. Обязательно Отсутствует
IsEnabledProperty событие изменения свойства. Обязательно Отсутствует
StructureChangedEvent Обязательно Отсутствует
ToggleStateProperty событие изменения свойства. Обязательно Отсутствует

Действие по умолчанию

Действие флажка по умолчанию — это фокусировка на радио-кнопке и переключение её текущего состояния. Как упоминалось ранее, флажки либо представляют двоичное решение (Да/Нет) (Вкл./Выкл.) пользователю, либо троичное (Вкл., Выкл., Неопределено). Если флажок имеет двойственное состояние, действие по умолчанию приводит к переключению состояния с "включено" на "выключено" или с "выключено" на "включено". В третичном состоянии действие по умолчанию переключает состояние флажка в том же порядке, как если бы пользователь последовательно щелкал мышью по элементу управления.

См. также