Compartir a través de

Compatibilidad de UI Automation para el tipo de control RadioButton

Nota:

Esta documentación está pensada para desarrolladores de .NET Framework que desean usar las clases de automatización de la interfaz de usuario administradas definidas en el espacio de nombres System.Windows.Automation. Para obtener la información más reciente sobre la automatización de la interfaz de usuario, consulte API de Windows Automation: Automatización de la interfaz de usuario.

En este tema se proporciona información sobre la compatibilidad de automatización de la interfaz de usuario con el tipo de control RadioButton. En UI Automation, un tipo de control es un conjunto de condiciones que un control debe cumplir para poder usar la propiedad ControlTypeProperty. Las condiciones incluyen directrices específicas para la estructura de árbol de UI Automation , los valores de propiedad de esta y los patrones de control.

Un botón de radio consta de un botón redondo y texto definido por la aplicación (una etiqueta), un icono o un mapa de bits que indica una opción que el usuario puede realizar seleccionando el botón. Normalmente, una aplicación usa botones de radio en un cuadro de grupo para permitir al usuario elegir entre un conjunto de opciones relacionadas, pero mutuamente excluyentes. Por ejemplo, la aplicación podría presentar un grupo de botones de radio desde los que el usuario puede seleccionar una preferencia de formato para el texto seleccionado en el área de cliente. El usuario podría seleccionar un formato alineado a la izquierda, alineado a la derecha o centrado seleccionando el botón de radio correspondiente. Normalmente, el usuario solo puede seleccionar una opción a la vez desde un conjunto de botones de radio.

En las secciones siguientes se define la estructura de árbol de automatización de la interfaz de usuario necesaria, las propiedades, los patrones de control y los eventos para el tipo de control RadioButton. Los requisitos de automatización de la interfaz de usuario se aplican a todos los controles de lista, ya sea Windows Presentation Foundation (WPF), Win32 o Windows Forms.

Estructura de árbol de Automatización de la interfaz de usuario necesaria

En la tabla siguiente se muestra la vista de control y la vista de contenido del árbol de automatización de la interfaz de usuario que pertenece a los controles de botón de radio y se describe lo que se puede contener en cada vista. Para más información sobre el árbol de automatización de la interfaz de usuario, consulte Introducción al árbol de automatización de la interfaz de usuario.

Vista de control Vista de contenido
RadioButton RadioButton

No hay elementos secundarios en la vista de control ni en la vista de contenido.

Propiedades de Automatización de la interfaz de usuario necesarias

En la tabla siguiente se enumeran las propiedades de automatización de la interfaz de usuario cuyo valor o definición es especialmente relevante para el tipo de control RadioButton. Para más información sobre las propiedades de automatización de la interfaz de usuario, consulte Propiedades de automatización de la interfaz de usuario: Propiedades para clientes.

Propiedad de automatización de interfaz de usuario Importancia Notas
AutomationIdProperty Vea las notas. El valor de esta propiedad debe ser único en todos los controles de una aplicación.
BoundingRectangleProperty Vea las notas. El rectángulo exterior que contiene el control completo.
IsKeyboardFocusableProperty Vea las notas. Si el control puede recibir el foco del teclado, debe admitir esta propiedad.
NameProperty Vea las notas. El nombre del control de botón de radio es el texto que se muestra junto al botón que mantiene el estado de selección.
ClickablePointProperty Vea las notas. El punto que se puede hacer clic en el control de botón de radio debe ser un punto que establece la selección en el botón de radio si se hace clic con un puntero del mouse.
LabeledByProperty Null Los botones de radio son controles con etiquetas propias.
ControlTypeProperty RadioButton Este valor es el mismo para todos los marcos de trabajo de la interfaz de usuario.
LocalizedControlTypeProperty "Botón de radio" Cadena localizada que corresponde al tipo de control RadioButton.
IsContentElementProperty Cierto El control de botón de radio siempre se incluye en la vista de contenido del árbol de automatización de la interfaz de usuario.
IsControlElementProperty Cierto El control de botón de radio siempre se incluye en la vista de control del árbol de automatización de la interfaz de usuario.

Patrones de control de automatización de la interfaz de usuario necesarios

En la tabla siguiente se enumeran los patrones de control de automatización de la interfaz de usuario necesarios para ser compatibles con todos los controles de botón de radio. Para obtener más información sobre los patrones de control, consulte Introducción a los patrones de control de automatización de la interfaz de usuario.

Patrón de control/Propiedad del patrón de control Soporte técnico/valor Notas
ISelectionItemProvider Sí Todos los controles de botón de radio deben admitir el patrón Selection Item para permitir que se seleccionen.
SelectionContainer Vea las notas. SelectionContainerProperty Siempre debe completarse para que un cliente de Automatización de la interfaz de usuario pueda determinar qué otros botones de radio dentro de un contexto específico se relacionan entre sí. Para la versión Win32 del botón de radio, esta propiedad no se admitirá porque no es posible obtener esta información de ese marco heredado.
IToggleProvider Nunca El botón de radio no puede recorrer su estado una vez establecido. Este patrón nunca se debe admitir en el botón de radio.

Eventos de Automatización de la interfaz de usuario necesarios

En la tabla siguiente se enumeran los eventos de automatización de la interfaz de usuario que deben admitir todos los controles de botón de radio. Para más información sobre los eventos, vea UI Automation Events Overview.

Evento de Automatización de la interfaz de usuario Apoyo Notas
ElementRemovedFromSelectionEvent Obligatorio Ninguno
ElementSelectedEvent Obligatorio Ninguno
Evento cambiado por propiedadToggleStateProperty . Nunca Ninguno
Evento cambiado por propiedadBoundingRectangleProperty . Obligatorio Ninguno
Evento cambiado por propiedadIsOffscreenProperty . Obligatorio Ninguno
Evento cambiado por propiedadIsEnabledProperty . Obligatorio Ninguno
AutomationFocusChangedEvent Obligatorio Ninguno
StructureChangedEvent Obligatorio Ninguno

Consulte también