CListCtrl (clase) encapsula la funcionalidad de una "lista control de vista," que muestra una colección de elementos, cada uno formado por un icono (a partir de una lista de imágenes) y una etiqueta. Además de un icono y etiqueta, cada elemento puede tener información que se muestra en las columnas a la derecha del icono y etiqueta. Este control (y por lo tanto, la clase CListCtrl ) está disponible sólo para los programas que se ejecutan bajo Windows 95 y Windows NT versión 3.51 y posteriores.
La siguiente es una breve reseña de la clase CListCtrl . Para una discusión conceptual detallada, consulte Usando CListCtrl y Temas de Control en la Guía del programador de Visual C++.
Vistas
Controles de vista de lista pueden mostrar su contenido en cuatro formas diferentes, llamados "vistas".
Cada elemento aparece como un icono tamaño completo (32 x 32 píxeles) con una etiqueta debajo de él. El usuario puede arrastrar los elementos a cualquier ubicación de la ventana de vista de lista.
Cada elemento aparece como un icono pequeño (16 x 16 píxeles) con la etiqueta a la derecha. El usuario puede arrastrar los elementos a cualquier ubicación de la ventana de vista de lista.
Cada elemento aparece como un pequeño icono con una etiqueta a la derecha. Los elementos se organizan en columnas y no pueden ser arrastrados a cualquier ubicación de la ventana de vista de lista.
Cada elemento aparece en su propia línea, con información adicional que se organizan en columnas a la derecha. La columna izquierda contiene el icono pequeño y etiqueta y columnas posteriores contienen subelementos como especificado por la aplicación. Un control de encabezado incrustado (clase CHeaderCtrl) implementa estas columnas. Para obtener más información sobre el control de encabezado y columnas en una vista de informe, consulte CListCtrl uso: agregar columnas al Control (vista de informe).
El estilo de vista de lista actual del control determina la vista actual. Para obtener más información sobre estos estos estilos y su uso, consulte CListCtrl uso: cambiar estilos de Control de lista de.
Estilos extendidos
Además de los estilos de lista estándar, clase CListCtrl soporta un amplio conjunto de estilos extendidos, proporcionando funcionalidad enriquecida. Algunos ejemplos de esta funcionalidad:
Cuando está habilitado, permite la selección automática de un elemento cuando el cursor permanece sobre el elemento durante un determinado período de tiempo.
Cuando está habilitado, permite el control soportar hasta elementos DWORD . Esto es posible mediante la colocación de la sobrecarga de administración de datos de elementos de la aplicación. Excepto para la selección de artículos e información de foco, toda la información de elemento debe administrarse por la aplicación. Para obtener más información, consulte CListCtrl uso: controles de lista Virtual.
Cuando está habilitado, permite el seguimiento activo (resaltado automático del texto del elemento) y one– o two– activación haga clic en el elemento resaltado.
Cuando está habilitado, permite arrastrar y soltar reordenación de columnas en un control de vista de lista. Sólo disponible en la vista de informe.
Para información sobre cómo utilizar estos nuevos extendido estilos, consulte CListCtrl uso: cambiar estilos de Control de lista de.
Elementos y subelementos
Cada elemento de un control de vista de lista consta de un icono (a partir de una lista de imágenes), una etiqueta, un estado actual y un valor definido por la aplicación (denominados "datos de elemento"). Uno o varios subelementos también pueden asociarse con cada elemento. Un "subelemento" es una cadena que, en vista de informe, se puede mostrar en una columna a la derecha del icono y la etiqueta de un elemento. Todos los elementos de un control de vista de lista deben tener el mismo número de subelementos.
Clase CListCtrl proporciona varias funciones para insertar, eliminar, buscar y modificar estos elementos. Para obtener más información, véase CListCtrl::GetItem, CListCtrl::InsertItemy CListCtrl::FindItem, CListCtrl uso: agregar elementos al Control, y CListCtrl utilizando: desplazamiento, organizar, ordenar y buscar en la lista de controles.
De forma predeterminada, el control de vista de lista es responsable de almacenar atributos de icono y el texto de un elemento. Sin embargo, además de estos tipos de elemento, clase CListCtrl admite "artículos de devolución de llamada". Un "artículo de devolución de llamada" es un elemento de vista de lista para que la aplicación — en lugar de control: almacena el texto, icono o ambos. Una máscara de devolución de llamada se utiliza para especificar los atributos de elemento (texto o icono) son suministrados por la aplicación. Si una aplicación utiliza elementos de devolución de llamada, debe ser capaz de suministrar los atributos de texto o icono de demanda. Artículos de devolución de llamada son útiles cuando la aplicación ya mantiene parte de esta información. Para obtener más información, consulte CListCtrl::GetCallBackMask y CListCtrl uso: artículos de devolución de llamada y la máscara de devolución de llamada.
Listas de imágenes
Los iconos, imágenes de elemento de encabezado y application– definen Estados de vista de lista elementos figuran en varias listas de imágenes (implementadas por clase CImageList), que puede crea y asigna al control de vista de lista. Cada control de vista de lista puede tener hasta cuatro diferentes tipos de listas de imágenes:
Utilizado en la vista de iconos para los iconos de tamaño completo.
Utiliza iconos pequeños, lista y vistas de informe para versiones reducidas de los iconos que se utilizan en la vista de iconos.
Contiene imágenes de Estado, que se muestran junto al icono de un elemento para indicar un estado definido por la aplicación.
Utilizado en la vista de informe para pequeñas imágenes que aparecen en cada elemento del control de encabezado.
De forma predeterminada, un control de vista de lista destruye las listas de imagen asignadas cuando es destruido; Sin embargo, el desarrollador puede personalizar este comportamiento mediante la destrucción de cada lista de imagen cuando ya no se utiliza, según lo determinado por la aplicación. Para obtener más información, consulte CListCtrl utilizando: listas de imágenes y elementos de la lista y CListCtrl utilizando: listas de imágenes y elementos de la lista.
# include lt;afxcmn.h>
Miembros de la clase | Clase base | Diagrama de jerarquía
Muestras Ejemplo de MFC DAOTABLE | Ejemplo de MFC HTTPSVR | Ejemplo de MFC LISTHDR | Ejemplo de MFC ROWLIST | Ejemplo de MFC DBVLIST
Vea tambié&nnbsp;CImageList