Compartir a través de

CVSListBox (clase)

  • Artículo

La clase CVSListBox admite un control de lista modificable.

Sintaxis

class CVSListBox : public CVSListBoxBase

Miembros

Constructores públicos

Nombre Descripción
CVSListBox::CVSListBox Construye un objeto CVSListBox.
CVSListBox::~CVSListBox Destructor.

Métodos públicos

Nombre Descripción
CVSListBox::AddItem Agrega una cadena a un control de lista. (Invalida CVSListBoxBase::AddItem).
CVSListBox::EditItem Inicia una operación de edición en el texto de un elemento de control de lista. (Invalida CVSListBoxBase::EditItem).
CVSListBox::GetCount Recupera el número de cadenas de un control de lista editable. (Invalida CVSListBoxBase::GetCount).
CVSListBox::GetItemData Recupera un valor de 32 bits específico de la aplicación asociado a un elemento de control de lista editable. (Invalida CVSListBoxBase::GetItemData).
CVSListBox::GetItemText Recupera el texto de un elemento de control de lista editable. (Invalida CVSListBoxBase::GetItemText).
CVSListBox::GetSelItem Recupera el índice de base cero del elemento seleccionado actualmente en un control de lista editable. (Invalida CVSListBoxBase::GetSelItem).
CVSListBox::PreTranslateMessage Traduce los mensajes de ventana antes de enviarlos a las funciones de Windows TranslateMessage y DispatchMessage. Para más información y conocer la sintaxis de método, consulta CWnd::P reTranslateMessage. (Invalida CVSListBoxBase::PreTranslateMessage).
CVSListBox::RemoveItem Quita un elemento de un control de lista editable. (Invalida CVSListBoxBase::RemoveItem).
CVSListBox::SelectItem Selecciona una cadena de control de lista editable. (Invalida CVSListBoxBase::SelectItem).
CVSListBox::SetItemData Asocia un valor de 32 bits específico de la aplicación a un elemento de control de lista editable. (Invalida CVSListBoxBase::SetItemData).

Métodos protegidos

Nombre Descripción
CVSListBox::GetListHwnd Devuelve el identificador al control de vista de lista insertado actual.

Comentarios

La clase CVSListBox proporciona un conjunto de botones de edición que permiten al usuario crear, modificar, eliminar o reorganizar los elementos de un control de lista.

A continuación se muestra una imagen del control de lista editable. La segunda entrada de lista, que se denomina "Item2", está seleccionada para su edición.

Control CVSListBox.

Si usa el editor de recursos para agregar un control de lista editable, observe que el panel Cuadro de herramientas del editor no proporciona un control de lista editable predefinido. En su lugar, agregue un control estático, como el control Cuadro de grupo. El marco usa el control estático como marcador de posición para especificar el tamaño y la posición del control de lista editable.

Para usar un control de lista editable en una plantilla de cuadro de diálogo, declare una variable CVSListBox en la clase de cuadro de diálogo. Para admitir el intercambio de datos entre la variable y el control, defina una entrada de macro DDX_Control en el método DoDataExchange del cuadro de diálogo. De forma predeterminada, el control de lista editable se crea sin botones de edición. Use el método CVSListBoxBase::SetStandardButtons heredado para habilitar los botones de edición.

Para más información, consulte el directorio Samples, el ejemplo New Controls, los archivos Page3.cpp y Page3.h.

Jerarquía de herencia

CObject

CCmdTarget

CWnd

CStatic

CVSListBoxBase

CVSListBox

Requisitos

Encabezado: afxvslistbox.h

CVSListBox::AddItem

Agrega una cadena a un control de lista.

virtual int AddItem(
    const CString& strIext,
    DWORD_PTR dwData=0,
    int iIndex=-1);

Parámetros

strIext
[in] Referencia a una cadena.

dwData
[in] Valor de 32 bits específico de la aplicación asociado a la cadena. El valor predeterminado es 0.

iIndex
[in] Índice de base cero de la posición que contendrá la cadena. Si el parámetro iIndex es -1, la cadena se agrega al final de la lista. El valor predeterminado es -1.

Valor devuelto

Índice de base cero de la posición de la cadena en el control de lista.

Comentarios

Use el método CVSListBox::GetItemData para recuperar el valor especificado por el parámetro dwData. Este valor puede ser un entero específico de la aplicación o un puntero a otros datos.

CVSListBox::CVSListBox

Construye un objeto CVSListBox.

CVSListBox();

Valor devuelto

Comentarios

CVSListBox::EditItem

Inicia una operación de edición en el texto de un elemento de control de lista.

virtual BOOL EditItem(int iIndex);

Parámetros

iIndex
[in] Índice de base cero de un elemento de control de lista.

Valor devuelto

TRUE si la operación de edición se inicia correctamente; de lo contrario, FALSE.

Comentarios

El usuario inicia una operación de edición haciendo doble clic en la etiqueta de un elemento o presionando la tecla F2 o BARRA ESPACIADORA cuando un elemento tiene el foco.

CVSListBox::GetCount

Recupera el número de cadenas de un control de lista editable.

virtual int GetCount() const;

Valor devuelto

Número de elementos en el control de lista.

Comentarios

Tenga en cuenta que el recuento es uno mayor que el valor de índice del último elemento porque el índice está basado en cero.

CVSListBox::GetItemData

Recupera un valor de 32 bits específico de la aplicación asociado a un elemento de control de lista editable.

virtual DWORD_PTR GetItemData(int iIndex) const;

Parámetros

iIndex
[in] Índice de base cero de un elemento de control de lista editable.

Valor devuelto

El valor de 32 bits que está asociado al elemento especificado.

Comentarios

Use el método CVSListBox::SetItemData o CVSListBox::AddItem para asociar el valor de 32 bits al elemento de control de lista. Este valor puede ser un entero específico de la aplicación o un puntero a otros datos.

CVSListBox::GetItemText

Recupera el texto de un elemento de control de lista editable.

virtual CString GetItemText(int iIndex) const;

Parámetros

iIndex
[in] Índice de base cero de un elemento de control de lista editable.

Valor devuelto

Objeto CString que contiene el texto del elemento especificado.

Comentarios

CVSListBox::GetListHwnd

Devuelve el identificador al control de vista de lista insertado actual.

virtual HWND GetListHwnd() const;

Valor devuelto

Identificador del control de vista de lista insertado.

Comentarios

Use este método para recuperar un identificador para el control de vista de lista insertado que admite la clase CVSListBox.

CVSListBox::GetSelItem

Recupera el índice de base cero del elemento seleccionado actualmente en un control de lista editable.

virtual int GetSelItem() const;

Valor devuelto

Si este método se ejecuta correctamente, el índice de base cero del elemento seleccionado actualmente; de lo contrario, -1.

Comentarios

CVSListBox::RemoveItem

Quita un elemento de un control de lista editable.

virtual BOOL RemoveItem(int iIndex);

Parámetros

iIndex
[in] Índice de base cero de un elemento de control de lista editable.

Valor devuelto

TRUE si se ha quitado el elemento especificado; de lo contrario, FALSE.

Comentarios

CVSListBox::SelectItem

Selecciona una cadena de control de lista editable.

virtual BOOL SelectItem(int iItem);

Parámetros

iItem
[in] Índice de base cero de un elemento de control de lista editable.

Valor devuelto

TRUE si este método se ejecuta correctamente; de lo contrario, FALSE.

Comentarios

Este método selecciona el elemento especificado y, si es necesario, desplaza el elemento a la vista.

CVSListBox::SetItemData

Asocia un valor de 32 bits específico de la aplicación a un elemento de control de lista editable.

virtual void SetItemData(
    int iIndex,
    DWORD_PTR dwData);

Parámetros

iIndex
[in] Índice de base cero de un elemento de control de lista editable.

dwData
[in] Valor de 32 bits. Este valor puede ser un entero específico de la aplicación o un puntero a otros datos.

Comentarios

Consulte también

Gráfico de jerarquías
Clases