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

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

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

Примечание

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

 

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

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

• Типичная древовидная структура
• Релевантные свойства
• Обязательные шаблоны элементов управления
• Обязательные события
• Замечания
• Связанные темы

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

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

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

 

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

Релевантные свойства

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

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

 

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

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

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

 

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

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

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

 

Комментарии

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

Связанные темы

Основные понятия

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

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