Compartir a través de

Tipo de control ComboBox

  • Artículo

En este tema se proporciona información sobre la compatibilidad de Automatización de la interfaz de usuario de Microsoft para 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 del cuadro de lista del control se muestra en todo momento o solo aparece cuando el usuario selecciona la flecha desplegable (que es un botón de inserción) 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 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 ComboBox. Los requisitos de automatización de la interfaz de usuario se aplican a todos los controles de cuadro combinado en los que la plataforma o plataforma de la interfaz de usuario integra la compatibilidad con automatización de la interfaz de usuario para los tipos de control y los patrones de control.

Este tema contiene las secciones siguientes.

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 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
  • ComboBox
    • Editar (0 o 1)
    • Lista (0 o 1)
    • Elemento de lista (elemento secundario de lista; de 0 a varios)
    • Botón (1)
  • ComboBox
    • Elemento de lista (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 combinado de cuadro de diálogo Ejecutar.

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 el ComboBox tipo de control. 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_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 ComboBox
UIA_HelpTextPropertyId Vea las notas. El texto de ayuda de los controles de cuadro combinado debe explicar por qué se le pide al usuario que elija una opción del cuadro combinado. El texto es similar a la información presentada a través de una información sobre herramientas. Por ejemplo, "Seleccione un elemento para establecer la resolución de visualización del monitor".
UIA_IsContentElementPropertyId VERDADERO 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 VERDADERO 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 VERDADERO 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 de cuadro combinado puede recibir el foco.
UIA_LabeledByPropertyId Vea las notas. Normalmente, los controles de cuadro combinado tienen una etiqueta de texto estático a la que hace referencia esta propiedad.
UIA_LocalizedControlTypePropertyId Vea las notas. Cadena localizada correspondiente al ComboBox tipo de control. El valor predeterminado es "cuadro combinado" para en-US o inglés (Estados Unidos).
UIA_NamePropertyId Vea las notas. El nombre del control de cuadro combinado normalmente se genera 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 de. 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 enumeran los patrones de control de automatización de la interfaz de usuario necesarios para ser compatibles con todos los controles de cuadro combinado. 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 Apoyo Notas
IExpandCollapseProvider Obligatorio Se debe admitir el patrón de control ExpandCollapse 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 patrón de control Selection se delega en el cuadro de lista situado debajo del cuadro combinado, pero puede 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 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 Value, 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 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_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_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 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