Tipo de control ComboBox

  • 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 ComboBox.

Un cuadro combinado es un cuadro de lista combinado con un control estático o un control de edición que muestra el elemento seleccionado actualmente en la parte del cuadro de lista del cuadro combinado. La parte de cuadro de lista del control se muestra en todo momento o solo aparece cuando el usuario selecciona la flecha de lista desplegable (que es un botón de comando) junto al control. Si el campo de selección es un control de edición, el usuario puede escribir información que no esté en la lista; de lo contrario, el usuario solo puede seleccionar elementos de la lista.

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 ComboBox. Los requisitos de Automatización de la interfaz de usuario se aplican a todos los controles de cuadro combinado en los que el marco o la plataforma de la interfaz de usuario se 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 cuadro combinado 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
  • ComboBox
    • Edición (0 o 1)
    • Lista (0 o 1)
    • List Item (elemento secundario de List; de 0 a varios)
    • Button (1)
  • ComboBox
    • List Item (de 0 a varios)

 

El control de edición de la vista de control del cuadro combinado solo es necesario si el cuadro combinado se puede editar para tomar cualquier entrada, como es el caso del cuadro combinado en el cuadro de diálogo Ejecutar .

Propiedades pertinentes

En la tabla siguiente se enumeran las propiedades Automatización de la interfaz de usuario cuyo valor o definición es especialmente relevante para el tipo de control ComboBox. 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_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, invalide y proporcione un punto en el que se pueda hacer clic.
UIA_ControlTypePropertyId ComboBox
UIA_HelpTextPropertyId Vea las notas. El texto de ayuda de los controles de cuadro combinado debe explicar por qué se pide al usuario que elija una opción del cuadro combinado. El texto es similar a la información que se presenta mediante un elemento de información sobre herramientas. Por ejemplo, "Seleccione un elemento para establecer la resolución de pantalla del monitor".
UIA_IsContentElementPropertyId TRUE Los controles de cuadro combinado siempre se incluyen en la vista de contenido del árbol de automatización de la interfaz de usuario.
UIA_IsControlElementPropertyId TRUE Los controles de cuadro combinado siempre se incluyen en la vista de control del árbol de automatización de la interfaz de usuario.
UIA_IsKeyboardFocusablePropertyId TRUE Los controles de cuadro combinado pueden recibir el foco del teclado; sin embargo, cuando un cliente de Automatización de la interfaz de usuario establece el foco en un cuadro combinado, cualquier elemento del subárbol del cuadro combinado puede recibir el foco.
UIA_LabeledByPropertyId Vea las notas. Los controles de cuadro combinado suelen tener una etiqueta de texto estático a la que hace referencia esta propiedad.
UIA_LocalizedControlTypePropertyId Vea las notas. Cadena localizada correspondiente al tipo de control ComboBox . El valor predeterminado es "combo box" para en-US o inglés (Estados Unidos).
UIA_NamePropertyId Vea las notas. El nombre del control de cuadro combinado se genera normalmente a partir de una etiqueta de texto estático. Si no hay una etiqueta de texto estático, debe asignar un valor para la propiedad Name . La propiedad Name nunca debe contener el contenido actual del cuadro combinado o cambiar cuando cambie el contenido del cuadro combinado.

 

Patrones de control necesarios

En la tabla siguiente se muestran los patrones de control de automatización de la interfaz de usuario necesarios para que todos los controles de cuadro combinado los admitan. Para más información sobre los patrones de control, vea UI Automation Control Patterns Overview.

Patrón de control Soporte técnico Notas
IExpandCollapseProvider Obligatorio El patrón de control ExpandCollapse debe admitirse porque un control de cuadro combinado siempre debe contener un botón desplegable.
ISelectionProvider Depende Muestra la selección actual en el cuadro combinado. La compatibilidad con el patrón de control Selección se delega en el cuadro de lista debajo del cuadro combinado, pero es posible que no siempre sea factible.
IValueProvider Depende Si el cuadro combinado puede tomar valores de texto arbitrarios, se debe admitir el patrón de control Value . Este patrón permite establecer mediante programación el contenido de cadena del cuadro combinado. Si no se admite el patrón de control Valor, el usuario debe seleccionar entre los elementos de lista del subárbol del cuadro combinado.
IScrollProvider Nunca El patrón de control Scroll nunca se admite directamente en un cuadro combinado. Se admite si un cuadro de lista contenido en un cuadro combinado puede desplazarse y solo cuando el cuadro de lista está visible en la pantalla.

 

Eventos necesarios

En la tabla siguiente se enumeran los eventos de Automatización de la interfaz de usuario que los controles de cuadro combinado 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_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_StructureChangedEventId
UIA_ExpandCollapseExpandCollapseStatePropertyId evento de cambio de propiedad.
UIA_ValueValuePropertyId evento de cambio de propiedad. Si el control admite el patrón de control Value , debe admitir este evento.

 

Conceptual

Información general sobre tipos de control de UI Automation

Información general sobre UI Automation