Clase wxListView
Esta clase actualmente simplemente presenta una interfaz más simple de usar para wxListCtrl - puede considerarse como una interfaz para esa complicada clase.
Jerarquía:
Es preferible usarla a usar wxListCtrl directamente siempre que sea posible porque en el futuro algunos ports podrían implementar wxListView pero no el conjunto completo de características de wxListCtrl.
Aparte de una interfaz diferente, esta clase es idéntica a wxListCtrl. En particular, utiliza los mismos eventos, los mismos estilos de ventana, etc.
Funciones miembro
wxListView()
wxListView::wxListView()
Constructor por defecto.
wxListView()
wxListView::wxListView( wxWindow * parent, wxWindowID winid = wxID_ANY, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, long style = wxLC_REPORT, const wxValidator & validator = wxDefaultValidator, const wxString & name = wxListCtrlNameStr )
Constructor, crea y muestra un control listview.
Parámetros
- parent
- Ventana padre. No debe ser nullptr.
- winid
- Identificador de la ventana. El valor wxID_ANY indica un valor por defecto.
- pos
- Posición de la ventana. Si se especifica wxDefaultPosition se elige una posición por defecto.
- size
- Tamaño de la ventana. Si se especifica wxDefaultSize, la ventana tendrá el tamaño adecuado.
- style
- Estilo de la ventana.
- validator
- Validador de la ventana.
- name
- Nombre de la ventana.
~wxListView()
virtual wxListView::~wxListView()
Destructor, destruye el control listview.
ClearColumnImage()
void wxListView::ClearColumnImage(int col)
Restablece la imagen de la columna - después de llamar a esta función, no se mostrará ninguna imagen.
Parámetros
- col
- La columna para la que se desea borrar la imagen
Focus()
void wxListView::Focus(long index)
Fija el foco en el elemento con el índice dado.
GetFirstSelected()
long wxListView::GetFirstSelected() const
Devuelve el primer elemento seleccionado en un control de selección múltiple (presumiblemente).
Junto con GetNextSelected() puede utilizarse para iterar sobre todos los elementos seleccionados en el control.
Devuelve
El primer elemento seleccionado, si existe, -1 en caso contrario.
GetFocusedItem()
long wxListView::GetFocusedItem() const
Devuelve el elemento actualmente enfocado o -1 si no hay ninguno.
GetNextSelected()
long wxListView::GetNextSelected(long item) const
Se utiliza junto con GetFirstSelected() para iterar sobre todos los elementos seleccionados en el control.
Valor de retorno
Devuelve el siguiente elemento seleccionado o -1 si no hay más.
IsSelected()
bool wxListView::IsSelected(long index) const
Devuelve true si el elemento con el índice dado está seleccionado, false en caso contrario.
Select()
void wxListView::Select( long n, bool on = true )
Selecciona o deselecciona el elemento dado.
Observar que este método hereda el comportamiento inusual de wxListCtrl::SetItemState() que envía un evento wxEVT_LIST_ITEM_SELECTED cuando se utiliza para seleccionar un elemento, contrariamente a la regla habitual de que sólo las acciones del usuario resultan en la selección.
Parámetros
- n
- El ítem a seleccionar o deseleccionar.
- on
- Si es true (por defecto), selecciona el elemento, en caso contrario lo deselecciona
SetColumnImage()
void wxListView::SetColumnImage( int col, int image )
Establece la imagen de columna para la columna especificada.
Para utilizar las imágenes de columna, el control debe tener una lista de imágenes válida con al menos una imagen.
Parámetros
- col
- La columna para la que se desea establecer la imagen.
- image
- El índice de la imagen de la columna en la lista de imágenes del control.
Métodos y datos heredados
Esta clase hereda los métodos y datos miembro públicos y protegidos de wxListCtrl, wxControl, wxWindow, wxEvtHandler y wxObject.