Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 Microsoft UI Automation con el tipo de control CheckBox. En automatización de la interfaz de usuario, un tipo de control es un conjunto de condiciones que un control debe cumplir para poder usar la ControlTypeProperty propiedad . Las condiciones incluyen directrices específicas para la estructura de árboles de automatización de la interfaz de usuario, los valores de propiedad y los patrones de control de automatización de la interfaz de usuario.
Una casilla es un objeto que se usa para indicar un estado con el que los usuarios pueden interactuar para recorrer ese estado. Las casillas presentan una opción binaria (Sí/No), (Activado/Desactivado) o terciaria (Activado, Desactivado, Indeterminado) al usuario.
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 CheckBox. Los requisitos de automatización de la interfaz de usuario se aplican a todos los controles de casilla, 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 casilla de verificación y se describe lo que se puede contener en cada vista. Para obtener 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 |
|---|---|
| CheckBox | CheckBox |
Nota:
Las casillas nunca tienen elementos secundarios en el control o la vista de contenido. Si el control necesita contener elementos secundarios, indica que se debe usar otro tipo de control.
Propiedades necesarias de automatización de la interfaz de usuario
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 los controles de casilla. Para obtener 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 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. |
| ClickablePointProperty | Vea las notas. | Se admite si hay un rectángulo delimitador. Si no todos los puntos que se encuentran dentro del rectángulo delimitador son seleccionables, y realiza pruebas de aciertos especializadas, invalide y ofrezca un punto en el que hacer clic. |
| ControlTypeProperty | CheckBox | Este valor es el mismo para todos los marcos de trabajo de la interfaz de usuario. |
| IsContentElementProperty | Cierto | El valor de esta propiedad siempre debe ser True. Esto significa que el control de casilla siempre debe incluirse en la vista de contenido del árbol de automatización de la interfaz de usuario. |
| IsControlElementProperty | Cierto | El valor de esta propiedad siempre debe ser True. Esto significa que el control de casilla siempre debe incluirse en la vista de control del árbol de automatización de la interfaz de usuario. |
| IsKeyboardFocusableProperty | Vea las notas. | Si el control puede recibir el foco del teclado, debe admitir esta propiedad. |
| LabeledByProperty | Null |
Las casillas son controles de etiquetado automático. |
| LocalizedControlTypeProperty | "casilla" | Cadena localizada correspondiente al tipo de control CheckBox. |
| NameProperty | Vea las notas. | El valor de la propiedad del Name control de casilla es el texto que se muestra junto al cuadro que mantiene el estado de alternancia. |
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 casilla. Para más información sobre los patrones de control, vea UI Automation Control Patterns Overview.
| Patrón de control | Apoyo | Notas |
|---|---|---|
| IToggleProvider | Obligatorio | Permite que la casilla se recorra mediante programación sus estados internos. |
Eventos necesarios de automatización de la interfaz de usuario
En la tabla siguiente se enumeran los eventos de automatización de la interfaz de usuario que deben admitir todos los controles de casilla. Para obtener más información sobre los eventos, consulte UI Automation Events Overview.
| Evento de Automatización de la interfaz de usuario | Apoyo | Notas |
|---|---|---|
| AutomationFocusChangedEvent | Obligatorio | Ninguno |
| BoundingRectangleProperty evento de cambio de propiedad. | Obligatorio | Ninguno |
| IsOffscreenProperty evento de cambio de propiedad. | Obligatorio | Ninguno |
| IsEnabledProperty evento de cambio de propiedad. | Obligatorio | Ninguno |
| StructureChangedEvent | Obligatorio | Ninguno |
| ToggleStateProperty evento de cambio de propiedad. | Obligatorio | Ninguno |
Acción predeterminada
La acción predeterminada de la casilla es hacer que un botón de radio se centre y desactive su estado actual. Como se mencionó anteriormente, las casillas presentan una decisión binaria (Sí/No) (Activado/Desactivado) al usuario o a un terciario (Activado, Desactivado, Indeterminado). Si la casilla es binaria, la acción predeterminada hace que el estado "activado" se convierta en "desactivado" o el estado "desactivado" se convertirá en "activado". En un estado terciario, la acción predeterminada recorre los estados de la casilla en el mismo orden que si el usuario hubiera enviado clics sucesivos del mouse al control.