control List-View (referencia de elementos de interfaz de usuario de MSAA)

  • Artículo

Nota

En este tema se describen los objetos List-View Control con fines de referencia de elementos de interfaz de usuario de MSAA. Aquí no se describe cómo crear objetos List-View Control 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 control de vista de lista muestra una colección de elementos, cada uno de los cuales consta de un icono y una etiqueta, y proporciona varias maneras de mostrar y organizar los elementos. Por ejemplo, se muestra información adicional sobre cada elemento en columnas a la derecha del icono y la etiqueta. El Explorador de Windows usa un control de vista de lista para mostrar archivos.

El nombre de clase de ventana de un control de vista de lista es WC_LISTVIEW, que se define como "SysListView" en Commctrl.h.

Métodos IAccessible

Un control de vista de lista admite los siguientes métodos IAccessible :

Método Comentarios
accDoDefaultAction El propio objeto de vista de lista no tiene una propiedad DefaultAction ; sin embargo, el método accDoDefaultAction hace doble clic en elementos de vista de lista.
accHitTest
accLocation
accNavigate
accSelect

Propiedades IAccessible

Un control de vista de lista admite las siguientes propiedades IAccessible :

Propiedad Comentarios
get_accChild
get_accChildCount La propiedad ChildCount es el número de elementos de la lista.
get_accDefaultAction El propio objeto de vista de lista no tiene una propiedad DefaultAction ; sin embargo, la propiedad DefaultAction de cada elemento de vista de lista es "Doble clic".
get_accDescription El propio objeto de vista de lista no admite la propiedad Description ; sin embargo, la propiedad Description de cada elemento de vista de lista es el texto contenido en las columnas segundas y posteriores del elemento. Se inserta una coma entre el texto de cada columna.
get_accFocus
get_accHelp
get_accHelpTopic
get_accKeyboardShortcut Los objetos list-views no tienen métodos abreviados de teclado. Sin embargo, si el texto de la ventana del control de vista de lista contiene un carácter de y comercial (&), Microsoft Active Accessibility devuelve una cadena que no es Null como la propiedad KeyboardShortcut .
get_accName El nombre del objeto de vista de lista se obtiene del texto de la ventana del control (o subtítulo). Este texto no se muestra con el control de vista de lista, por lo que los desarrolladores de servidores deben proporcionar texto significativo en la instrucción de definición de recursos del control para ayudar a los usuarios de utilidades de cliente a identificar el control. Para los elementos de vista de lista, la propiedad Name es el texto del elemento de lista.
get_accParent El elemento primario del objeto de vista de lista es una ventana ( ROLE_SYSTEM_WINDOW ) que rodea el control y tiene la misma propiedad Name y el mismo nombre de clase de ventana que el control. La propiedad Parent de los elementos de vista de lista es el objeto list-view.
get_accRole El rol de ROLE_SYSTEM_LIST y cada elemento del control de vista de lista tiene la propiedad Role de ROLE_SYSTEM_LISTITEM.
get_accSelection
get_accState La propiedad State del objeto de vista de lista es una combinación de uno o varios de los valores siguientes: STATE_SYSTEM_INVISIBLE STATE_SYSTEM_UNAVAILABLE | | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_OFFSCREEN
La propiedad State de los elementos de vista de lista es una combinación de uno o varios de los valores siguientes:
| STATE_SYSTEM_INVISIBLE | STATE_SYSTEM_FOCUSED | STATE_SYSTEM_FOCUSABLE | STATE_SYSTEM_SELECTABLE | STATE_SYSTEM_SELECTED | STATE_SYSTEM_MULTISELECTABLE | STATE_SYSTEM_HOTTRACKED | STATE_SYSTEM_OFFSCREEN STATE_SYSTEM_NORMAL
Además, los elementos de la vista de lista de casillas también tienen el estado STATE_SYSTEM_CHECKED.

Notas

  • La accesibilidad activa de Microsoft no expone el texto del elemento de vista de lista en las aplicaciones que usan una función de devolución de llamada para agregar el texto al elemento.
  • Los elementos de vista de lista que se recortan no tienen STATE_SYSTEM_INVISIBLE establecido. Para determinar si se recorta un elemento de lista, los clientes pueden comparar las coordenadas del elemento devueltas por accLocation con la región de recorte de la ventana.
  • La accesibilidad activa de Microsoft no admite el uso del método accNavigate para navegar al control de encabezado dentro de un control de vista de lista que se encuentra en la vista Detalles. Sin embargo, los clientes usan la función AccessibleObjectFromPoint para obtener el control de encabezado.
  • En el caso de objetos no rectangulares, como elementos de vista de lista en la vista Detalles, las coordenadas del rectángulo delimitador del elemento recuperado por accLocation producen un error si se prueban con accHitTest porque accHitTest determina los límites del objeto en píxel por píxel.

IAccessible (Interfaz)