Поддержка модели автоматизированного пользовательского интерфейса для элемента управления CheckBox
Примечание.
Эта документация предназначена для разработчиков .NET Framework, желающих использовать управляемые классы автоматизации пользовательского интерфейса, определенные в пространстве имен System.Windows.Automation. Последние сведения об автоматизации пользовательского интерфейса см. в статье API автоматизации Windows. Автоматизация пользовательского интерфейса.
В этом разделе содержатся сведения о поддержке Microsoft модель автоматизации пользовательского интерфейса для типа элемента управления CheckBox. В модель автоматизации пользовательского интерфейса тип элемента управления — это набор условий, которые элемент управления должен соответствовать для использования ControlTypeProperty свойства. Условия включают конкретные рекомендации по структуре дерева модель автоматизации пользовательского интерфейса, модель автоматизации пользовательского интерфейса значения свойств и шаблоны элементов управления.
Флажок — это объект, используемый для указания состояния, с которым пользователи могут взаимодействовать для циклического перебора этого состояния. Флажки представляют пользователю выбор из двух (да/нет, вкл./выкл.) или трех (вкл., выкл., не определено) вариантов.
В следующих разделах определяется необходимая структура дерева модель автоматизации пользовательского интерфейса, свойства, шаблоны элементов управления и события для типа элемента управления CheckBox. Требования модель автоматизации пользовательского интерфейса применяются ко всем элементам управления проверка box, будь то Windows Presentation Foundation (WPF), Win32 или Windows Forms.
Требуемая древовидная структура модели автоматизации пользовательского интерфейса
В следующей таблице показано представление элемента управления и представление содержимого дерева модель автоматизации пользовательского интерфейса, относящегося к элементам управления проверка поля и описывающее, что можно содержать в каждом представлении. Дополнительные сведения о дереве модель автоматизации пользовательского интерфейса см. в модель автоматизации пользовательского интерфейса обзоре дерева.
| Представление элемента управления | Представление содержимого |
|---|---|
| CheckBox | CheckBox |
Примечание.
Флажки не имеют дочерних элементов в представлении элемента управления и в представлении содержимого. Если элемент управления должен содержать дочерние элементы, значит следует использовать другой тип элемента управления.
Требуемые свойства модели автоматизации пользовательского интерфейса
В следующей таблице перечислены свойства модель автоматизации пользовательского интерфейса, значение или определение которых особенно важно для элементов управления проверка поля. Дополнительные сведения о свойствах модель автоматизации пользовательского интерфейса см. в разделе модель автоматизации пользовательского интерфейса Свойства для клиентов.
| Свойство модели автоматизации пользовательского интерфейса | Значение | Примечания. |
|---|---|---|
| AutomationIdProperty | См. примечания. | Значение этого свойства должно быть уникальным среди всех элементов управления в приложении. |
| BoundingRectangleProperty | См. примечания. | Внешний прямоугольник, содержащий весь элемент управления. |
| ClickablePointProperty | См. примечания. | Поддерживается при наличии ограничивающего прямоугольника. Если не все точки внутри ограничивающего прямоугольника являются интерактивными и выполняется специализированная проверка на наличие данных, выполните переопределение и предоставьте интерактивную точку. |
| ControlTypeProperty | CheckBox | Это значение является одинаковым для всех инфраструктур пользовательского интерфейса. |
| IsContentElementProperty | Истина | Это свойство всегда должно иметь значение True. Это означает, что элемент управления проверка поля всегда должен быть включен в представление содержимого дерева модель автоматизации пользовательского интерфейса. |
| IsControlElementProperty | Истина | Это свойство всегда должно иметь значение True. Это означает, что элемент управления проверка поля всегда должен быть включен в представление элемента управления дерева модель автоматизации пользовательского интерфейса. |
| IsKeyboardFocusableProperty | См. примечания. | Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство. |
| LabeledByProperty | Null |
Элементы управления «Флажок» получают метку автоматически. |
| LocalizedControlTypeProperty | «флажок» | Локализованная строка, соответствующая типу элемента управления CheckBox. |
| NameProperty | См. примечания. | Значением свойства Name элемента управления «Флажок» является текст, отображаемый рядом с полем для состояния переключения. |
Необходимые шаблоны элементов управления модели автоматизации пользовательского интерфейса
В следующей таблице перечислены шаблоны элементов управления модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления проверка box. Дополнительные сведения о шаблонах элементов управления см. в разделе UI Automation Control Patterns Overview.
| Шаблон элемента управления | Поддержка | Примечания. |
|---|---|---|
| IToggleProvider | Обязательное поле | Позволяет флажку циклически проходить через его внутренние состояния программным образом. |
Необходимые события модели автоматизации пользовательского интерфейса
В следующей таблице перечислены события модель автоматизации пользовательского интерфейса, которые должны поддерживаться всеми элементами управления проверка поля. Дополнительные сведения о событиях см. в разделе UI Automation Events Overview.
| событие модель автоматизации пользовательского интерфейса | Поддержка | Примечания. |
|---|---|---|
| AutomationFocusChangedEvent | Обязательное поле | нет |
| Событие изменения свойстваBoundingRectangleProperty | Обязательное поле | нет |
| Событие изменения свойстваIsOffscreenProperty | Обязательное поле | нет |
| Событие изменения свойстваIsEnabledProperty | Обязательное поле | нет |
| StructureChangedEvent | Обязательное поле | нет |
| Событие изменения свойстваToggleStateProperty | Обязательное поле | нет |
Действие по умолчанию
Действие по умолчанию флажка — вызов переключателя для получения фокуса и переключение текущего состояния. Как упоминалось выше, флажки представляют пользователю выбор из двух (да/нет, вкл./выкл.) или трех (вкл., выкл., не определено) вариантов. Если флажок является двоичным, в результате действия по умолчанию состояние «вкл.» становится состоянием «выкл.», или состояние «выкл.» становится «вкл.». В третичном флажке действие по умолчанию проходит через состояния флажка в том порядке, как если бы пользователь успешно щелкал мышью этот элемент управления.