CListCtrl Class

Artículo
06/10/2015

Encapsula la funcionalidad de un “control de la vista de lista,” que muestra una colección de elementos cada uno que consta de un icono (de una imagen lista) y una etiqueta.

class CListCtrl : public CWnd

Members

Constructores públicos

Name	Descripción
CListCtrl::CListCtrl	Crea un objeto CListCtrl.

Métodos públicos

Name	Descripción
CListCtrl::ApproximateViewRect	Determina el ancho y el alto necesarios para mostrar los elementos de un control de vista de lista.
CListCtrl::Arrange	alinea elementos en una cuadrícula.
CListCtrl::CancelEditLabel	Cancela la operación de edición de texto del elemento.
CListCtrl::Create	Crea un control de lista y lo asocia a un objeto de CListCtrl .
CListCtrl::CreateDragImage	Crea una imagen de arrastre incluida para un elemento especificado.
CListCtrl::CreateEx	Crea un control de lista con Windows especificado extendidas estilos y lo asocia a un objeto de CListCtrl .
CListCtrl::DeleteAllItems	Elimina todos los elementos del control.
CListCtrl::DeleteColumn	Elimina una columna del control de vista de lista.
CListCtrl::DeleteItem	Elimina un elemento del control.
CListCtrl::DrawItem	Se invoca cuando un aspecto visual de un control de dibujo propietario.
CListCtrl::EditLabel	Inicia la edición en contexto de texto de un elemento.
CListCtrl::EnableGroupView	Habilita o deshabilita si los elementos en una vista de lista de control muestre como grupo.
CListCtrl::EnsureVisible	Garantiza que un elemento sea visible.
CListCtrl::FindItem	Buscar un elemento listview que especifica características.
CListCtrl::GetBkColor	Recupera el color de fondo de un control de vista de lista.
CListCtrl::GetBkImage	Recupera la imagen de fondo actual de un control de vista de lista.
CListCtrl::GetCallbackMask	Recupera la máscara de devolución de llamada para un control de vista de lista.
CListCtrl::GetCheck	Recupera el estado actual de la imagen del estado asociado a un elemento.
CListCtrl::GetColumn	recupera los atributos de una columna de control.
CListCtrl::GetColumnOrderArray	Recupera el orden de la columna (de izquierda a derecha) de un control de vista de lista.
CListCtrl::GetColumnWidth	Recupera el ancho de una columna en la vista de informe o una vista de lista.
CListCtrl::GetCountPerPage	Calcula el número de elementos que pueden ajustarse verticalmente en un control de vista de lista.
CListCtrl::GetEditControl	Recupera el identificador del control de edición se usa para editar el texto de un elemento.
CListCtrl::GetEmptyText	Recupera la cadena para mostrar si el control actual de la vista de lista está vacío.
CListCtrl::GetExtendedStyle	Recupera los estilos extendidos actuales de un control de vista de lista.
CListCtrl::GetFirstSelectedItemPosition	Recupera la posición del primer elemento seleccionado de la vista de lista en un control de vista de lista.
CListCtrl::GetFocusedGroup	Recupera el grupo que tiene el foco de teclado en el control actual de la vista de lista.
CListCtrl::GetGroupCount	Recupera el número de grupos en el control actual de la vista de lista.
CListCtrl::GetGroupInfo	Obtiene la información para un grupo especificado del control de vista de lista.
CListCtrl::GetGroupInfoByIndex	Información de recupera sobre un grupo especificado en el control actual de la vista de lista.
CListCtrl::GetGroupMetrics	Recupera las medidas de un grupo.
CListCtrl::GetGroupRect	recupera el rectángulo delimitador para un grupo especificado en el control actual de la vista de lista.
CListCtrl::GetGroupState	Recupera el estado para un grupo especificado en el control actual de la vista de lista.
CListCtrl::GetHeaderCtrl	Recupera el control de encabezado de un control de vista de lista.
CListCtrl::GetHotCursor	Recupera el cursor utilizado cuando el seguimiento activo se habilita para un control de vista de lista.
CListCtrl::GetHotItem	Recupera el elemento de vista de lista actualmente en el cursor.
CListCtrl::GetHoverTime	Recupera la hora actual de suspensión de un control de vista de lista.
CListCtrl::GetImageList	Recupera el identificador de una imagen que se utiliza para dibujar los elementos de la vista de lista.
CListCtrl::GetInsertMark	Recupera la posición actual de marca de inserción.
CListCtrl::GetInsertMarkColor	Recupera el color actual de marca de inserción.
CListCtrl::GetInsertMarkRect	recupera el rectángulo que limita el punto de inserción.
CListCtrl::GetItem	Recupera los atributos de un elemento de vista de lista.
CListCtrl::GetItemCount	Recupera el número de elementos en un control de vista de lista.
CListCtrl::GetItemData	Recupera el valor específico de la aplicación asociada a un elemento.
CListCtrl::GetItemIndexRect	Recupera el rectángulo delimitador del todo o parte de un subelemento en el control actual de la vista de lista.
CListCtrl::GetItemPosition	Recupera la posición de un elemento de vista de lista.
CListCtrl::GetItemRect	recupera el rectángulo delimitador para un elemento.
CListCtrl::GetItemSpacing	Calcula el espaciado entre los elementos del control actual de la vista de lista.
CListCtrl::GetItemState	Recupera el estado de un elemento de vista de lista.
CListCtrl::GetItemText	Recupera el texto de un elemento o un subelemento de la vista de lista.
CListCtrl::GetNextItem	Buscar un elemento listview con las propiedades y con la relación especificada a un elemento determinado.
CListCtrl::GetNextItemIndex	Recupera el índice del elemento en el control actual de la vista de lista que tiene un conjunto especificado de propiedades.
CListCtrl::GetNextSelectedItem	Recupera el índice de una posición del elemento de vista de lista, y la posición del elemento seleccionado siguiente de la vista de lista para recorrer.
CListCtrl::GetNumberOfWorkAreas	Recupera el número actual de zonas de trabajo para un control de vista de lista.
CListCtrl::GetOrigin	Recupera el origen de la vista actual para un control de vista de lista.
CListCtrl::GetOutlineColor	Recupera el color del borde de un control de vista de lista.
CListCtrl::GetSelectedColumn	Recupera el índice de la columna actualmente seleccionada en el control de lista.
CListCtrl::GetSelectedCount	Recupera el número de elementos seleccionados en el control de vista de lista.
CListCtrl::GetSelectionMark	Recupera la marca de la selección de un control de vista de lista.
CListCtrl::GetStringWidth	Determina el ancho de columna mínimo necesario mostrar toda la cadena especificada.
CListCtrl::GetSubItemRect	Recupera el rectángulo delimitador de un elemento en un control de vista de lista.
CListCtrl::GetTextBkColor	Recupera el color de fondo del texto de un control de vista de lista.
CListCtrl::GetTextColor	Recupera el color del texto de un control de vista de lista.
CListCtrl::GetTileInfo	Información de recupera sobre un mosaico en un control de vista de lista.
CListCtrl::GetTileViewInfo	Información de recupera sobre un control de vista de lista en la vista en mosaico.
CListCtrl::GetToolTips	Recupera el control de información sobre herramientas del control de vista de lista utiliza para mostrar información sobre herramientas.
CListCtrl::GetTopIndex	Recupera el índice del elemento visible superior.
CListCtrl::GetView	Obtiene la vista de control de la vista de lista.
CListCtrl::GetViewRect	Recupera el rectángulo delimitador de todos los elementos del control de vista de lista.
CListCtrl::GetWorkAreas	Recupera las zonas de trabajo actuales de un control de vista de lista.
CListCtrl::HasGroup	Determina si el control de vista de lista tiene el grupo especificado.
CListCtrl::HitTest	Determina que el elemento de vista de lista aparece en una posición especificada.
CListCtrl::InsertColumn	Inserta una nueva columna en un control de vista de lista.
CListCtrl::InsertGroup	Inserta un grupo en el control de vista de lista.
CListCtrl::InsertGroupSorted	Inserta el grupo especificado en una lista ordenada de grupos.
CListCtrl::InsertItem	Inserta un nuevo elemento en un control de vista de lista.
CListCtrl::InsertMarkHitTest	Recupera el punto de inserción más próximo a un punto especificado.
CListCtrl::IsGroupViewEnabled	Determina si la vista del grupo está habilitada para un control de vista de lista.
CListCtrl::IsItemVisible	Indica si un elemento especificado en el control actual de la vista de lista está visible.
CListCtrl::MapIDToIndex	Asigna el identificador único de un elemento en el control actual de la lista-vista para un índice.
CListCtrl::MapIndexToID	asigna el índice de un elemento en el control actual de la vista de lista a una identificación única
CListCtrl::MoveGroup	Mueve el grupo especificado.
CListCtrl::MoveItemToGroup	Mueve el grupo especificado al cero índice basado especificado del control de vista de lista.
CListCtrl::RedrawItems	Fuerza un control de vista de lista para que vuelva a un intervalo de elementos.
CListCtrl::RemoveAllGroups	Quita todos los grupos de un control de vista de lista.
CListCtrl::RemoveGroup	Quita el grupo especificado del control de vista de lista.
CListCtrl::Scroll	Desplaza el contenido de un control de vista de lista.
CListCtrl::SetBkColor	Establece el color de fondo del control de vista de lista.
CListCtrl::SetBkImage	Establece la imagen de fondo actual de un control de vista de lista.
CListCtrl::SetCallbackMask	Establece la máscara de devolución de llamada para un control de vista de lista.
CListCtrl::SetCheck	Establece el estado actual de la imagen del estado asociado a un elemento.
CListCtrl::SetColumn	establece los atributos de una columna de la vista de lista.
CListCtrl::SetColumnOrderArray	Establece el orden de la columna (de izquierda a derecha) de un control de vista de lista.
CListCtrl::SetColumnWidth	Cambia el ancho de una columna en la vista de informe o una vista de lista.
CListCtrl::SetExtendedStyle	Establece los estilos extendidos actuales de un control de vista de lista.
CListCtrl::SetGroupInfo	Establece la información del grupo especificado de un control de vista de lista.
CListCtrl::SetGroupMetrics	Establece las métricas de grupo de un control de vista de lista.
CListCtrl::SetHotCursor	Establece el cursor utilizado cuando el seguimiento activo se habilita para un control de vista de lista.
CListCtrl::SetHotItem	Establece el caso muy actual actual de un control de vista de lista.
CListCtrl::SetHoverTime	Establece la hora actual de suspensión de un control de vista de lista.
CListCtrl::SetIconSpacing	Establece el espaciado entre los iconos en un control de vista de lista.
CListCtrl::SetImageList	Asigna una lista de imágenes a un control de vista de lista.
CListCtrl::SetInfoTip	establece el texto de información sobre herramientas.
CListCtrl::SetInsertMark	Establece el punto de inserción en la posición definido.
CListCtrl::SetInsertMarkColor	Establece el color del punto de inserción.
CListCtrl::SetItem	Establece algunos o todos los atributos de un elemento de vista de lista.
CListCtrl::SetItemCount	Prepara un control de vista de lista para agregar un gran número de elementos.
CListCtrl::SetItemCountEx	Establece el número de elementos de un control de la vista de lista virtual.
CListCtrl::SetItemData	Establece el valor específico de la aplicación del elemento.
CListCtrl::SetItemIndexState	Establece el estado de un elemento en el control actual de la vista de lista.
CListCtrl::SetItemPosition	Mueve un elemento en una posición especificada de un control de vista de lista.
CListCtrl::SetItemState	Cambia el estado de un elemento en un control de vista de lista.
CListCtrl::SetItemText	Cambia el texto de un elemento o un subelemento de la vista de lista.
CListCtrl::SetOutlineColor	Establece el color del borde de un control de vista de lista.
CListCtrl::SetSelectedColumn	Establece la columna seleccionada del control de vista de lista.
CListCtrl::SetSelectionMark	Establece la marca de la selección de un control de vista de lista.
CListCtrl::SetTextBkColor	Establece el color de fondo del texto en un control de vista de lista.
CListCtrl::SetTextColor	Establece el color del texto de un control de vista de lista.
CListCtrl::SetTileInfo	Establece la información de un mosaico del control de vista de lista.
CListCtrl::SetTileViewInfo	Establece la información que un control de vista de lista utiliza en la vista en mosaico.
CListCtrl::SetToolTips	Establece el control de información sobre herramientas del control de vista de lista utilizará para mostrar información sobre herramientas.
CListCtrl::SetView	Establece la vista del control de vista de lista.
CListCtrl::SetWorkAreas	Establece el área donde los iconos se pueden mostrar en un control de vista de lista.
CListCtrl::SortGroups	Ordena los grupos de un control listview con una función definida por el usuario.
CListCtrl::SortItems	Los elementos de la vista de lista de las ordenaciones utilizando una comparación definido por la aplicación funciona.
CListCtrl::SortItemsEx	Los elementos de la vista de lista de las ordenaciones utilizando una comparación definido por la aplicación funciona.
CListCtrl::SubItemHitTest	Determina que el elemento de vista de lista, si existe, en una posición determinada.
CListCtrl::Update	Fuerza el control para que vuelva a un elemento especificado.

Comentarios

Además de un icono y una etiqueta, cada elemento puede tener información mostrada en columnas a la derecha del icono y label. Este control (y por consiguiente la clase de CListCtrl ) sólo está disponible para los programas que se ejecutan en versión 3,51 de Windows 95 /98 y Windows NT y posterior.

A continuación se muestra una información general de la clase de CListCtrl . Para obtener una explicación detallada, conceptual, vea Mediante CListCtrl y Controles.

Vistas

Los controles de la vista de lista pueden mostrar su contenido en cuatro maneras diferentes, denominadas “vistas.”

vista de iconos

Cada elemento aparece como píxeles del mismo tamaño de icono (32 x 32) con una etiqueta debajo de. el usuario puede arrastrar los elementos a cualquier ubicación en la ventana de la vista de lista.
pequeña vista de iconos

Cada elemento aparece como pequeños píxeles de icono (16 x 16) con la etiqueta a la derecha de. el usuario puede arrastrar los elementos a cualquier ubicación en la ventana de la vista de lista.
vista de lista

Cada elemento aparece como un pequeño icono con una etiqueta a la derecha de. Los elementos se organizan en columnas y no se pueden arrastrar a cualquier ubicación en la ventana de la vista de lista.
Vista de informe

Cada elemento aparece en su propia línea, con información adicional organizada en columnas a la derecha. la columna situada más a la izquierda contiene el pequeños icono y etiqueta, y las columnas subsiguientes contienen subelementos según lo especificado por la aplicación. un control de encabezado incrustado (clase CHeaderCtrl) implementa estas columnas. Para obtener más información sobre el control y las columnas del encabezado en una vista de informe, vea Mediante CListCtrl: Agregar columnas al Control (vista de informe).

Vea también:

Caso Q250614 de Knowledge Base: HOWTO: Ordenación de elementos en un CListCtrl en la vista de informe
Caso Q200054 de Knowledge Base: PRB: OnTimer() es Repeatedly denominado No para un control de lista

El estilo de la vista de lista actual del control determina la vista actual. Para obtener más información sobre estos estilos y su uso, vea Mediante CListCtrl: Cambiar los estilos del control de lista.

Estilos extendidos

Además de los estilos de lista estándar, la clase CListCtrl admite un conjunto grande de estilos extendidos, proporcionando funcionalidad enriquecida. Algunos ejemplos de esta funcionalidad son:

Selección de suspensión

Cuando está habilitada, permite la selección automática de un elemento cuando el cursor se mantiene sobre el elemento por un período de tiempo.
vistas de lista virtuales

Cuando está habilitada, permite que el control admita hasta DWORD elementos. Esto es posible colocar la sobrecarga de administración de datos de la aplicación. Salvo la selección de elementos y la información de foco, toda la información sobre el elemento se debe controlar por la aplicación. Para obtener más información, vea Mediante CListCtrl: controles de lista virtuales.
activación de uno y dos clic

Cuando está habilitada, permite el seguimiento activo (el resaltado automático del texto del elemento) y la activación de uno o dos en el elemento resaltado.
El orden de arrastrar y colocar de columna

Cuando está habilitada, permite reordenar arrastrar y colocar de columnas en un control de vista de lista. Sólo disponible en la vista de informe.

Para obtener información sobre cómo utilizar estos nuevos estilos extendidos, vea Mediante CListCtrl: Cambiar los estilos del control de lista.

elementos y subelementos

Cada elemento en un control de vista de lista está formada por un icono (de una imagen lista), una etiqueta, un estado actual, y un valor definido por la aplicación (denominado “datos de elemento”). Uno o más subelementos también pueden estar asociado a cada elemento. Un “subelemento” es una cadena que, en la vista de informe, se puede mostrar en una columna a la derecha del icono y la etiqueta de un elemento. Todos los elementos en un control de vista de lista deben tener el mismo número de subelementos.

La clase CListCtrl proporciona varias funciones para insertar, eliminar, buscar, y modificar estos elementos. Para obtener más información, vea CListCtrl:: GetItem, CListCtrl:: InsertItem, y CListCtrl:: FindItem, Mediante CListCtrl: Agregar elementos al Control, y Mediante CListCtrl: El desplazamiento, la disposición, el cambio y, al encontrar en controles de lista.

De forma predeterminada, el control de vista de lista es responsable de almacenar el icono y los atributos de texto de un elemento. Sin embargo, además de estos tipos de elemento, la clase CListCtrl admite “elementos de devolución de llamada”. Un “elemento de devolución de llamada” es un elemento de la vista de lista para el que la aplicación — en lugar del control )almacena el texto, el icono, o ambos. Una máscara de devolución de llamada se utiliza para especificar que los atributos del elemento (texto o icono) son proporcionados por la aplicación. Si una aplicación usa elementos de devolución de llamada, debe poder proporcionar los atributos de texto ni del icono a petición. Los elementos de devolución de llamada son útiles cuando la aplicación mantiene ya parte de esta información. Para obtener más información, vea Mediante CListCtrl: Elementos y el De Callback de devolución de llamada.

Listas de imágenes

Contienen los iconos, imágenes de elemento de encabezado, y estados definidos por la aplicación para los elementos de la vista de lista en varias listas de imágenes (implementados por la clase CImageList), que crea y asignar el control de vista de lista. Cada control de la vista de lista puede tener hasta cuatro tipos diferentes de listas de imágenes:

icono grande

Utilizado en la vista de iconos para los iconos del mismo tamaño.
Icono pequeño

Utilizado en el pequeños icono, lista, y vistas de informe para versiones más pequeñas de los iconos utilizados en la vista de iconos.
estado definido por la aplicación

Contiene imágenes de estado, que se muestran junto al icono de un elemento para indicar un estado definido por la aplicación.
Header Item

Utilizado en la vista de informe para las pequeñas imágenes que aparecen en cada elemento del control de encabezado.

De forma predeterminada, un control de vista de lista destruye listas de la imagen asignada al cuando se destruye; sin embargo, el programador puede personalizar este comportamiento destruyendo cada imagen que aparece cuando ya no se usa, determinado por la aplicación. Para obtener más información, vea Mediante CListCtrl: Elementos de lista y listas de Imágenes.