Cuadro combinado (referencia de elementos de interfaz de usuario de MSAA)
Nota
En este tema se describen los objetos Combo Box con fines de referencia de elementos de interfaz de usuario de MSAA. Aquí no se describe cómo crear objetos de cuadro combinado en varios marcos de interfaz de usuario. Consulte la documentación de referencia de API para el marco de interfaz de usuario que usa.
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 la lista desplegable cuando el usuario selecciona la flecha desplegable (que es un botón de pulsación) junto al control. Si el campo de selección es un control de edición, el usuario puede escribir información no en la lista; de lo contrario, el usuario solo puede seleccionar elementos de la lista.
El nombre de clase de ventana de un cuadro combinado es "COMBOBOX".
El contenido de las propiedades IAccessible depende de cuál de las siguientes partes del cuadro combinado se consulta mediante el cliente:
- Ventana del cuadro combinado
- Control de edición o control de texto estático
- Flecha desplegable (que es un botón de pulsación)
- Cuadro de lista
- Elementos de lista en el cuadro de lista
Métodos IAccessible
Los cuadros combinados admiten los siguientes métodos IAccessible :
Propiedades IAccessible
Los cuadros combinados admiten las siguientes propiedades IAccessible :
get_accChildCount: en la tabla siguiente se muestra el valor de recuento secundario para distintas partes del cuadro combinado.
Elemento de cuadro combinado ChildCount Ventana cuadro combinado 3 Edit (control) 0 Flecha desplegable 0 Cuadro de lista Número de elementos de lista Elemento de lista 0 get_accDefaultAction: en la tabla siguiente se muestra la propiedad DefaultAction para diferentes partes de un cuadro combinado.
Elemento de cuadro combinado DefaultAction Ventana cuadro combinado Ninguno Edit (control) Ninguno Flecha desplegable "Abrir" o "Cerrar" según el estado de la lista desplegable Cuadro de lista Ninguno Elemento de lista "Doble clic" get_accKeyboardShortcut: en la tabla siguiente se muestra la propiedad KeyboardShortcut para diferentes partes de un cuadro combinado.
Elemento de cuadro combinado KeyboardShortcut Ventana cuadro combinado Clave de acceso de la etiqueta asociada Edit (control) Ninguno Flecha desplegable "Alt+Flecha abajo" Cuadro de lista Ninguno Elemento de lista Ninguno La tecla de acceso de un cuadro combinado es el carácter subrayado del texto de un control de texto estático asociado que etiqueta el cuadro combinado. Por ejemplo, en un cuadro de diálogo Abrir estándar que abre archivos, como en Microsoft WordPad, el cuadro combinado con la etiqueta "Archivos de tipo:" tiene keyboardShortcut "Alt+t".
get_accName: en la tabla siguiente se muestra la propiedad Name para diferentes partes de un cuadro combinado.
Elemento de cuadro combinado Nombre Ventana cuadro combinado Control de texto estático usado como etiqueta Edit (control) Control de texto estático usado como etiqueta Flecha desplegable "Abrir" o "Cerrar" según el estado de la lista desplegable Cuadro de lista Etiqueta asociada Elemento de lista Texto del elemento de lista La propiedad Name de un cuadro combinado, su control de edición secundario y su cuadro de lista secundario es el texto de un control de texto estático asociado que etiqueta el cuadro combinado. Por ejemplo, en un cuadro de diálogo Abrir estándar que abre archivos, como en WordPad, las propiedades Name de los dos cuadros combinados son "Look in:" y "Files of type:".
get_accParent: en la tabla siguiente se muestra el valor primario de diferentes partes de un cuadro combinado.
Elemento de cuadro combinado Parent Ventana cuadro combinado Ventana con la propiedad Role de ROLE_SYSTEM_WINDOW que rodea el cuadro combinado y tiene la misma propiedad Name y el mismo nombre de clase de ventana que el cuadro combinado. Control De edición (o control de texto estático) Ventana del cuadro combinado. Flecha desplegable Ventana del cuadro combinado. Ventana primaria del cuadro de lista Ventana del cuadro combinado. Esta ventana rodea el cuadro de lista. Cuadro de lista Ventana primaria del cuadro de lista. Elemento de lista Cuadro de lista. get_accRole: en la tabla siguiente se muestra la propiedad Role para diferentes partes de un cuadro combinado.
Elemento de cuadro combinado Rol Ventana cuadro combinado ROLE_SYSTEM_COMBOBOX Control De edición (o control de texto estático) ROLE_SYSTEM_TEXT o ROLE_SYSTEM_STATICTEXT Flecha desplegable ROLE_SYSTEM_PUSHBUTTON Cuadro de lista ROLE_SYSTEM_LIST Elemento de lista ROLE_SYSTEM_LISTITEM get_accState: en la tabla siguiente se muestra la propiedad State para diferentes partes de un cuadro combinado.
Elemento de cuadro combinado Estados posibles Ventana cuadro combinado | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_NORMAL | STATE_SYSTEM_EXPANDED STATE_SYSTEM_COLLAPSED Edit (control) | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE STATE_SYSTEM_NORMAL Flecha desplegable 0, lo que significa que el botón está visible y no presionado; o STATE_SYSTEM_PRESSED STATE_SYSTEM_INVISIBLE | | STATE_SYSTEM_NORMAL Cuadro de lista | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_UNAVAILABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_FLOATING STATE_SYSTEM_NORMAL Elemento de lista | STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTED STATE_SYSTEM_NORMAL get_accValue: en la tabla siguiente se muestra la propiedad Value para diferentes partes de un cuadro combinado.
Elemento de cuadro combinado Valor Ventana cuadro combinado Texto del elemento de lista seleccionado actualmente Edit (control) Texto del elemento de lista seleccionado actualmente Flecha desplegable Ninguno Cuadro de lista Ninguno Elemento de lista None
Notas
- Cuando se llama a accNavigate con la marca NAVDIR_NEXT en la parte del cuadro de lista de un cuadro combinado, navega incorrectamente a la ventana de bandeja cuando debe devolver VT_EMPTY.
Temas relacionados
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de