Compartir a través de


Clase de CListBox

proporciona la funcionalidad de un cuadro de lista de Windows.

class CListBox : public CWnd

Members

y04ez4c9.collapse_all(es-es,VS.110).gifConstructores públicos

Name

Descripción

CListBox::CListBox

Crea un objeto CListBox.

y04ez4c9.collapse_all(es-es,VS.110).gifMé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.

Jerarquía de herencia

CObject

CCmdTarget

CWnd

CListBox

Requisitos

Encabezado: afxwin.h

Vea también

Referencia

Clase de CWnd

Gráfico de jerarquía

Clase de CWnd

Clase de CButton

Clase CComboBox

Clase de CEdit

Clase de CScrollBar

Clase de CStatic

Conceptos

ejemplo CTRLTEST de MFC