Tipo de control button

  • Artículo

En este tema se proporciona información sobre la compatibilidad de Microsoft Automatización de la interfaz de usuario 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 por ejemplo los botones Aceptar y Cancelar de un cuadro de diálogo. El control de botón es un control simple de exponer porque se asigna a un único comando que el usuario quiere realizar.

En las secciones siguientes se definen la estructura de árbol Automatización de la interfaz de usuario necesaria, las propiedades, los patrones de control y los eventos para el 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 el marco o plataforma de la interfaz de usuario integra Automatización de la interfaz de usuario compatibilidad con los tipos de control y los patrones de control.

En este tema se incluyen las siguientes secciones.

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 se describe lo que se puede contener en cada vista. Para más información sobre el árbol de UI Automation, vea Información general del árbol de UI Automation.

Vista de control Vista de contenido
  • Botón
    • Imagen (0 o más)
    • Text (0 o más)
  • Botón

 

Propiedades relevantes

En la tabla siguiente se enumeran las propiedades Automatización de la interfaz de usuario cuyo valor o definición es especialmente relevante para los controles que implementan el tipo de control Button (como los controles de botón). Para obtener más información sobre las propiedades de Automatización de la interfaz de usuario, vea Recuperar propiedades de Automatización de la interfaz de usuario Elements.

Propiedad de automatización de interfaz de usuario 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. El rectángulo exterior que contiene el control completo.
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 Button
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 TRUE El control de botón siempre debe ser contenido.
UIA_IsControlElementPropertyId TRUE 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 Null Los controles de botón se etiquetan automáticamente con su contenido.
UIA_LocalizedControlTypePropertyId Vea las notas. Cadena localizada correspondiente al tipo de control 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

La siguiente tabla enumera los patrones de control de UI Automation que deben soportar todos los controles de botón. Para más información sobre los patrones de control, vea UI Automation Control Patterns Overview.

Patrón de control/Propiedad de patrón Soporte técnico/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 ExpandCollapse en lugar del patrón de control Invoke o Toggle . El patrón de control ExpandCollapse se puede usar para abrir o cerrar un menú u otra subestructura asociada al elemento button.
IInvokeProvider Vea las notas. Todos los botones deben admitir el patrón de control Invocar o el patrón de control Alternar , 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 única operación, como cortar, copiar, pegar o eliminar.
IToggleProvider Vea las notas. Todos los botones deben admitir el patrón de control Invocar o el patrón de control Alternar , pero no ambos. El patrón de control Toggle debe admitirse si el botón puede recorrer una serie de hasta tres estados. Normalmente, se considera como un conmutador 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 los controles de botón son necesarios para admitir. Para más información sobre los eventos, vea 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 propiedad IsEnabled , 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 Toggle , debe admitir este evento.

 

Conceptual

Información general sobre tipos de control de UI Automation

Información general sobre UI Automation