control List-View (referencia de elemento de interfaz de usuario de MSAA)
Nota
En este tema se describen List-View objetos control con fines de referencia de elementos de interfaz de usuario de MSAA. No se describe cómo crear List-View Control objetos 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 list-view no tiene una propiedad DefaultAction; sin embargo, el métodoaccDoDefaultActionhace doble clic en elementos de vista de lista. |
| accHitTest | |
| accLocation | |
| accNavigate | |
| accSelect |
Propiedades de 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 list-view no tiene una propiedad DefaultAction; sin embargo, la propiedad DefaultAction para cada elemento de vista de lista es "Doble clic". |
| get_accDescription | El propio objeto list-view no admite la propiedad Description; sin embargo, la propiedad Description para 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 ampersand (&), Microsoft Active Accessibility devuelve una cadena que no es Null como la propiedad KeyboardShortcut. |
| get_accName | El Nombre para el objeto de vista de lista se obtiene del texto de la ventana del control (o tí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 la vista de lista, el propiedad Name es el texto del elemento de lista. |
| get_accParent | El primario de del objeto de vista de lista es una ventana ( ROLE_SYSTEM_WINDOW ) que rodea el control y tiene el mismo Nombre propiedad y 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 de ROLE_SYSTEM_LISTy 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 list-view es una combinación de uno o varios de los siguientes valores de : 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 acceder al control de encabezado.
- En el caso de objetos no rectangulares, como los 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 función de un píxel por píxel.