Compartir a través de


CListCtrl Class

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.

Jerarquía de herencia

CObject

CCmdTarget

CWnd

CListCtrl

Requisitos

encabezado: afxcmn.h

Vea también

Referencia

CWnd (Clase)

Gráfico de jerarquías

CImageList Class

Conceptos

ejemplo ROWLIST de MFC