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

Статья
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.

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

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

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

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

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

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

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

Представление элементов управления	Представление содержимого
CheckBox	CheckBox

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

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

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

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

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

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

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

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

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

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

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

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

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