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.
En este tema se proporciona información sobre la compatibilidad de Automatización de la interfaz de usuario de Microsoft con el tipo de control button.
Un botón es un objeto con el que un usuario interactúa para realizar una acción como los botones Aceptar y Cancelar en un cuadro de diálogo. El control de botón es un control sencillo que se expone porque se asigna a un único comando que el usuario desea completar.
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 del tipo de control Button. Los requisitos de automatización de la interfaz de usuario se aplican a todos los controles de botón en los que la plataforma o plataforma de la interfaz de usuario integra la compatibilidad de automatización de la interfaz de usuario con los tipos de control y los patrones de control.
Este tema contiene las secciones siguientes.
- estructura de árbol típica
- de propiedades pertinentes
- patrones de control necesarios
- eventos necesarios
- temas relacionados
Estructura de árbol típica
En la tabla siguiente se muestra un control típico y una vista de contenido del árbol de automatización de la interfaz de usuario que pertenece a los controles de botón y 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 |
|---|---|
|
|
Propiedades pertinentes
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 que implementan el Botón tipo de control (como los controles de botón). Para obtener más información sobre las propiedades de automatización de la interfaz de usuario, consulte Recuperar propiedades de elementos de automatización de la interfaz de usuario.
| Ui Automation (propiedad) | Valor | Notas |
|---|---|---|
| UIA_AcceleratorKeyPropertyId | Vea las notas. | Normalmente, un control de botón admite una tecla de aceleración para permitir que el usuario final realice rápidamente la acción representada por el botón desde el teclado. |
| UIA_AutomationIdPropertyId | Vea las notas. | El valor de esta propiedad debe ser único entre todos los elementos del mismo nivel en la vista sin procesar del árbol de automatización de la interfaz de usuario. |
| UIA_BoundingRectanglePropertyId | Vea las notas. | Rectángulo más externo que contiene todo el control. |
| UIA_ClickablePointPropertyId | Vea las notas. | Se admite si hay un rectángulo delimitador. Si no se puede hacer clic en todos los puntos del rectángulo delimitador, y el elemento realiza pruebas de posicionamiento especializadas, invalida y proporciona un punto en el que se puede hacer clic. |
| UIA_ControlTypePropertyId | de botón de | |
| UIA_HelpTextPropertyId | Vea las notas. | El texto de ayuda debe indicar cuál será el resultado final de la activación del botón. Normalmente, este es el mismo tipo de información que se presenta a través de una información sobre herramientas. |
| UIA_IsContentElementPropertyId | VERDADERO | El control de botón siempre debe ser contenido. |
| UIA_IsControlElementPropertyId | VERDADERO | El control de botón siempre debe ser un control. |
| UIA_IsKeyboardFocusablePropertyId | Vea las notas. | Si el control puede recibir el foco del teclado, debe admitir esta propiedad. |
| UIA_LabeledByPropertyId | Nulo | Los controles de botón se etiquetan automáticamente por su contenido. |
| UIA_LocalizedControlTypePropertyId | Vea las notas. | Cadena localizada correspondiente al tipo de control button button. El valor predeterminado es "button" para en-US o inglés (Estados Unidos). |
| UIA_NamePropertyId | Vea las notas. | El nombre del control de botón es el texto que se usa para etiquetarlo. Cada vez que se usa una imagen para etiquetar un botón, se debe proporcionar texto alternativo para la propiedad Name del botón. |
Patrones de control 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. 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 pattern | Compatibilidad/valor | Notas |
|---|---|---|
| IExpandCollapseProvider | Vea las notas. | Cuando un botón se hospeda como elemento secundario de un botón de división, el botón secundario puede admitir el patrón de control de ExpandCollapse en lugar del patrón de control invoke Invoke o Toggle. El patrón de control ExpandCollapse se puede usar para abrir o cerrar un menú u otra subestructura asociada al elemento de botón. |
| IInvokeProvider | Vea las notas. | Todos los botones deben admitir el patrón de control Invoke o el patrón de control toggle Toggle, pero no ambos. El patrón de control Invoke debe admitirse cuando el botón realiza un comando a petición del usuario. Este comando se asigna a una sola operación, como Cortar, Copiar, Pegar o Eliminar. |
| IToggleProvider | Vea las notas. | Todos los botones deben admitir el patrón de control Invoke o el patrón de control toggle Toggle, pero no ambos. El patrón de control Alternar debe admitirse si el botón puede recorrer una serie de hasta tres estados. Normalmente, esto se ve como un interruptor de encendido y apagado para características específicas. |
Eventos necesarios
En la tabla siguiente se enumeran los eventos de automatización de la interfaz de usuario que se necesitan controles de botón para admitir. Para obtener más información sobre los eventos, consulte ui Automation Events Overview.
| Evento de automatización de la interfaz de usuario | Notas |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId evento de cambio de propiedad. | |
| UIA_Invoke_InvokedEventId | Si el control admite el patrón de control invoke , debe admitir este evento. |
| UIA_IsEnabledPropertyId evento de cambio de propiedad. | Si el control admite la propiedadIsEnabled, debe admitir este evento. |
| UIA_IsOffscreenPropertyId evento de cambio de propiedad. | Si el control admite la propiedad IsOffscreen, debe admitir este evento. |
| UIA_NamePropertyId evento de cambio de propiedad. | |
| UIA_StructureChangedEventId | |
| UIA_ToggleToggleStatePropertyId evento de cambio de propiedad. | Si el control admite el patrón de control alternancia, debe admitir este evento. |
Temas relacionados
-
conceptual de
-
Introducción a los tipos de control de automatización de la interfaz de usuario de
-
información general de automatización de la interfaz de usuario de