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

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

В этом разделе содержатся сведения о поддержке моделью UI Automation элемента управления типа RadioButton. В UI Automation тип элемента управления представляет собой набор условий, которым должен удовлетворять элемент управления, чтобы использовать свойство ControlTypeProperty. К этим условиям относятся конкретные правила для древовидной структуры UI Automation, значений свойств UI Automation и шаблонов элементов управления.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

См. также

Ссылки

RadioButton

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

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

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