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

Тип элемента управления RadioButton

  • Статья

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

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

Заметка

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

 

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

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

Типичная структура дерева

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

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

 

Дочерние элементы в представлении элемента управления или представлении содержимого отсутствуют.

Соответствующие свойства

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

Свойство автоматизации пользовательского интерфейса Ценность Примечания
UIA_AutomationIdPropertyId См. заметки. Значение этого свойства должно быть уникальным среди всех одноранговых элементов в необработанном представлении дерева автоматизации пользовательского интерфейса.
UIA_BoundingRectanglePropertyId См. заметки. Самый внешний прямоугольник, содержащий весь элемент управления.
UIA_ClickablePointPropertyId См. заметки. Точка щелчка должна быть точкой, которая при щелчке выбирает переключатель.
UIA_ControlTypePropertyId RadioButton
UIA_IsContentElementPropertyId ИСТИННЫЙ Элемент управления переключателем всегда включается в представление содержимого дерева автоматизации пользовательского интерфейса.
UIA_IsControlElementPropertyId ИСТИННЫЙ Элемент управления переключателем всегда включается в представление элемента управления дерева автоматизации пользовательского интерфейса.
UIA_IsKeyboardFocusablePropertyId См. заметки. Если элемент управления может получить фокус клавиатуры, он должен поддерживать это свойство.
UIA_LabeledByPropertyId НЕДЕЙСТВИТЕЛЬНЫЙ Элементы управления переключателем самозаметятся содержимым.
UIA_LocalizedControlTypePropertyId См. заметки. Локализованная строка, соответствующая типу элемента управления RadioButton . Значение по умолчанию — "переключатель" для en-US или английского языка (США).
UIA_NamePropertyId См. заметки. Имя элемента управления переключателем — это текст, отображаемый рядом с кнопкой, которая поддерживает состояние выделения.

 

Обязательные шаблоны элементов управления

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

Управление шаблоном или свойством шаблонов Поддержка и значение Примечания
ISelectionItemProvider Обязательно Все элементы управления переключателем должны поддерживать шаблон SelectionItem, чтобы включить выбор самостоятельно.
SelectionContainer См. заметки. Свойство SelectionContainer всегда должно быть завершено, чтобы клиент автоматизации пользовательского интерфейса может определить, какие другие переключатели в определенном контексте связаны друг с другом. Для версии переключателя Microsoft Win32 это свойство не поддерживается, так как невозможно получить эти сведения из этой устаревшей платформы.
IToggleProvider Никогда Переключатель не может циклически пройти по состоянию после его установки. Шаблон управления переключателя никогда не должен поддерживаться на переключателе.

 

Обязательные события

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

Событие автоматизации пользовательского интерфейса Примечания
UIA_AutomationFocusChangedEventId
событие UIA_BoundingRectanglePropertyId изменено свойством.
событие UIA_IsEnabledPropertyId изменено свойством. Если элемент управления поддерживает свойство IsEnabled, он должен поддерживать это событие.
событие UIA_IsOffscreenPropertyId изменено свойством. Если элемент управления поддерживает свойство IsOffscreen, он должен поддерживать это событие.
UIA_SelectionItem_ElementRemovedFromSelectionEventId Если элемент управления поддерживает шаблон SelectionItem, он должен поддерживать это событие.
UIA_SelectionItem_ElementSelectedEventId Если элемент управления поддерживает шаблон SelectionItem, он должен поддерживать это событие.
UIA_StructureChangedEventId

 

Замечания

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

концептуальные

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

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