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

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

Замечание

Эта документация предназначена для разработчиков .NET Framework, которые хотят использовать управляемые классы автоматизации пользовательского интерфейса, определенные в пространстве имен System.Windows.Automation. Последние сведения об автоматизации пользовательского интерфейса см. в разделе API автоматизации Windows: автоматизация пользовательского интерфейса.

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

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

В следующих разделах определяется необходимая структура дерева автоматизации пользовательского интерфейса, свойства, шаблоны элементов управления и события для типа элемента управления RadioButton. Требования к автоматизации пользовательского интерфейса применяются ко всем элементам управления списками, будь то Windows Presentation Foundation (WPF), Win32 или Windows Forms.

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

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

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

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

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

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

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

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

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

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

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

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

Событие автоматизации пользовательского интерфейса Поддержка Примечания.
ElementRemovedFromSelectionEvent Обязательно Отсутствует
ElementSelectedEvent Обязательно Отсутствует
ToggleStateProperty событие изменения свойства. Никогда Отсутствует
BoundingRectangleProperty событие изменения свойства. Обязательно Отсутствует
IsOffscreenProperty событие изменения свойства. Обязательно Отсутствует
IsEnabledProperty событие изменения свойства. Обязательно Отсутствует
AutomationFocusChangedEvent Обязательно Отсутствует
StructureChangedEvent Обязательно Отсутствует

См. также