Clase de CListBox

Artículo
04/10/2013

proporciona la funcionalidad de un cuadro de lista de Windows.

class CListBox : public CWnd

Members

Constructores públicos

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

Métodos públicos

Name	Descripción
CListBox::AddString	agrega una cadena a un cuadro de lista.
CListBox::CharToItem	Reemplace para proporcionar WM_CHAR personalizado para los cuadros de lista dibujados por el propietario que no tienen cadenas.
CListBox::CompareItem	Llamado por el marco para determinar la posición de un nuevo elemento en un cuadro de lista ordenada de dibujo propietario.
CListBox::Create	Crea el cuadro de lista de Windows y lo asocia al objeto de CListBox .
CListBox::DeleteItem	Llamado por el marco cuando el usuario elimina un elemento de un cuadro de lista de dibujo propietario.
CListBox::DeleteString	elimina una cadena de un cuadro de lista.
CListBox::Dir	Agregar nombres de archivo, unidades, o ambas del directorio actual a un cuadro de lista.
CListBox::DrawItem	Llamado por el marco cuando un aspecto visual de los cambios de un cuadro de lista de dibujo propietario.
CListBox::FindString	Buscar una cadena en un cuadro de lista.
CListBox::FindStringExact	Encuentra la primera cadena del cuadro de lista que coincide con una cadena especificada.
CListBox::GetAnchorIndex	Recupera el índice de base cero del elemento actual de delimitación en un cuadro de lista.
CListBox::GetCaretIndex	Determina el índice del elemento que tiene el rectángulo de foco en un cuadro de lista de selección múltiple.
CListBox::GetCount	devuelve el número de cadenas en un cuadro de lista.
CListBox::GetCurSel	Devuelve el índice de base cero de la cadena seleccionado actualmente en un cuadro de lista.
CListBox::GetHorizontalExtent	Devuelve el ancho en píxeles que un cuadro de lista se puede desplazarse horizontalmente.
CListBox::GetItemData	Devuelve el valor de 32 bits asociado al elemento del cuadro de lista.
CListBox::GetItemDataPtr	Devuelve un puntero a un elemento del cuadro de lista.
CListBox::GetItemHeight	determina el alto de elementos en un cuadro de lista.
CListBox::GetItemRect	Devuelve el rectángulo delimitador del elemento del cuadro de lista que se muestra actualmente.
CListBox::GetListBoxInfo	recupera el número de elementos por columna.
CListBox::GetLocale	recupera el Id. de configuración regional para un cuadro de lista.
CListBox::GetSel	Devuelve el estado de selección de un elemento del cuadro de lista.
CListBox::GetSelCount	Devuelve el número de cadenas seleccionado actualmente en un cuadro de lista de selección múltiple.
CListBox::GetSelItems	Devuelve los índices de las cadenas seleccionado actualmente en un cuadro de lista.
CListBox::GetText	Copiar un elemento del cuadro de lista de un búfer.
CListBox::GetTextLen	Devuelve la longitud en bytes de un elemento del cuadro de lista.
CListBox::GetTopIndex	devuelve el índice de la primera cadena visible en un cuadro de lista.
CListBox::InitStorage	Reserva los bloques de memoria para los elementos y las cadenas del cuadro de lista.
CListBox::InsertString	Inserta una cadena en una ubicación concreta en un cuadro de lista.
CListBox::ItemFromPoint	Devuelve el índice del elemento del cuadro de lista cercana un punto.
CListBox::MeasureItem	Llamado por el marco cuando un cuadro de lista de dibujo propietario se crea para determinar dimensiones del cuadro de lista.
CListBox::ResetContent	borra todas las entradas de un cuadro de lista.
CListBox::SelectString	Busca y selecciona una cadena en un cuadro de lista de selección única.
CListBox::SelItemRange	Seleccione o anule la selección de un intervalo de cadenas en un cuadro de lista de selección múltiple.
CListBox::SetAnchorIndex	Establece el delimitador en un cuadro de lista de selección múltiple para iniciar una selección extendida.
CListBox::SetCaretIndex	Establece el rectángulo de foco al elemento en el índice especificado en un cuadro de lista de selección múltiple.
CListBox::SetColumnWidth	Establece el ancho de columna del cuadro de lista de varias columnas.
CListBox::SetCurSel	Selecciona una cadena en el cuadro de lista.
CListBox::SetHorizontalExtent	Establece el ancho en píxeles que un cuadro de lista se puede desplazarse horizontalmente.
CListBox::SetItemData	Establece el valor de 32 bits asociado al elemento del cuadro de lista.
CListBox::SetItemDataPtr	Establece un puntero al elemento del cuadro de lista.
CListBox::SetItemHeight	establece el alto de elementos en un cuadro de lista.
CListBox::SetLocale	establece el Id. de configuración regional para un cuadro de lista.
CListBox::SetSel	Seleccione o anule la selección de un elemento de cuadro de un cuadro de lista de selección múltiple.
CListBox::SetTabStops	Establece las posiciones de la interrupción de tabulación en un cuadro de lista.
CListBox::SetTopIndex	Establece el índice de base cero de la primera cadena visible en un cuadro de lista.
CListBox::VKeyToItem	Reemplace para proporcionar WM_KEYDOWN personalizado para los cuadros de lista con el estilo de LBS_WANTKEYBOARDINPUT .

Comentarios

Un cuadro de lista muestra una lista de elementos, como nombres de archivo, que el usuario puede ver y seleccione.

En un cuadro de lista de selección única, el usuario puede seleccionar un solo elemento.en un cuadro de lista de selección múltiple, un intervalo de elementos puede ser seleccionado.Cuando el usuario selecciona un elemento, aparecerá resaltada y el cuadro de lista envía un mensaje de notificación a la ventana primaria.

Puede crear un cuadro de lista de una plantilla de cuadro de diálogo o directamente en el código.Para hacerlo directamente, crear el objeto de CListBox , entonces para llamar a la función miembro de Crear para crear el control de cuadro de lista y adjuntar de Windows en el objeto de CListBox .Para utilizar un cuadro de lista en una plantilla de cuadro de diálogo, declarar una variable del cuadro de lista de la del cuadro de diálogo, después para utilizar DDX_Control en función de DoDataExchange de la del cuadro de diálogo para conectarse a la variable miembro al control.(esto se hace automáticamente al agregar una variable de control a la del cuadro de diálogo).

la construcción puede ser un proceso de un solo paso en una clase derivada de CListBox.Escriba un constructor para la clase derivada y llame a Crear dentro del constructor.

Si desea controlar los mensajes de notificación de Windows enviados por un cuadro de lista al elemento primario (normalmente una clase derivada de CDialog), agregue una función miembro de entrada y controlador de mensajes de mapa de mensajes a la clase primaria para cada mensaje.

Cada entrada de mapa de mensajes tiene el formato siguiente:

ON_Notification( id, memberFxn )

donde id especifica el identificador de ventana secundaria del control de cuadro de lista que envía la notificación y memberFxn es el nombre de la función principal del miembro que ha escrito para controlar la notificación.

El prototipo de función del elemento primario es el siguiente:

afx_msg void memberFxn( );

A continuación se muestra una lista de entradas posibles de mapa de mensajes y una descripción de los casos en que se enviaron al elemento primario:

El usuario deON_LBN_DBLCLK The hacer doble clic en una cadena en un cuadro de lista.Sólo un cuadro de lista que tiene el estilo de LBS_NOTIFY enviará este mensaje de notificación.
El cuadro de lista deON_LBN_ERRSPACE no puede asignar memoria suficiente para resolver la solicitud.
El cuadro de lista deON_LBN_KILLFOCUS The está realizando el foco de entrada.
La selección actual del cuadro de lista deON_LBN_SELCANCEL The se cancela.Este mensaje se envía cuando un cuadro de lista tiene el estilo de LBS_NOTIFY .
La selección deON_LBN_SELCHANGE The en el cuadro de lista ha cambiado.Esta notificación no se envía si la selección está realiza una función miembro de CListBox:: SetCurSel .Esta notificación se aplica solamente a un cuadro de lista con el estilo de LBS_NOTIFY .El mensaje de notificación de LBN_SELCHANGE se envía para un cuadro de lista de selección múltiple siempre que el usuario presione una tecla de dirección, aunque la selección no cambia.
El cuadro de lista deON_LBN_SETFOCUS The está recibiendo el foco de entrada.
ON_WM_CHARTOITEM un cuadro de lista de propietario- dibujo que no tiene ninguna cadena recibe un mensaje de WM_CHAR .
El cuadro de lista deON_WM_VKEYTOITEM con el estilo de LBS_WANTKEYBOARDINPUT recibe un mensaje de WM_KEYDOWN .

Si crea un objeto de CListBox dentro de un cuadro de diálogo (a través de un recurso de cuadro de diálogo), el objeto de CListBox automáticamente se destruye cuando el usuario cierra el cuadro de diálogo.

Si crea un objeto de CListBox dentro de una ventana, puede ser necesario destruir el objeto de CListBox .Si crea el objeto de CListBox en la pila, se destruye automáticamente.Si crea el objeto de CListBox en la pila mediante la función de nuevo , debe llamar a cancelación en el objeto para destruirlo cuando el usuario cierra la ventana primaria.

Si asigna cualquier memoria en el objeto de CListBox , reemplace CListBox destructor para eliminar de la asignación.