CVSListBox (clase)
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.
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
CVSListBoxBase
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
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de