Тип элемента управления RadioButton
В этом разделе содержатся сведения о поддержке типа элемента управления RadioButton в Microsoft модель автоматизации пользовательского интерфейса.
Переключатель состоит из круглой кнопки и определяемого приложением текста (метки), значка или растрового изображения, указывающего выбор, который может сделать пользователь, нажав кнопку. Обычно в приложениях переключатели объединяются в группу, чтобы пользователь мог выбирать из набора связанных, но взаимоисключающих вариантов. Например, приложение может представлять группу переключателей, из которых пользователь может выбрать вариант форматирования текста, выделенного в клиентской области текста. Пользователь может выбрать выравнивание по левому краю, по правому краю или по центру, выбрав соответствующий переключатель. Обычно пользователь может за один раз выбрать только один вариант в наборе переключателей.
Примечание
Другим универсальным элементом управления для кнопок, где можно выбрать только один элемент в группе, является содержимое переключателя. Некоторые платформы пользовательского интерфейса считают переключатель специализированным переключателем.
В следующих разделах определяются необходимые модель автоматизации пользовательского интерфейса древовидной структуры, свойств, шаблонов элементов управления и событий для типа элемента управления 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 |
Комментарии
Переключатель представляет один выбираемый параметр в группе одноранговых переключателей. В идеале переключатели должны иметь элемент группировки, который определяет границы одноранговых переключателей. Однако часто граница подразумевается структурой элементов пользовательского интерфейса. Например, меню может содержать набор последовательных переключателей вместо пунктов меню или набор переключателей, которые появляются после метки группы, но перед интерактивным элементом, таким как кнопка.
Связанные темы
-
Основные понятия
-
Общие сведения о типах элементов управления автоматизации пользовательского интерфейса
-
Общие сведения о модели автоматизации пользовательского интерфейса
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по