Clase wxDataViewListCtrl
Esta clase es un wxDataViewCtrl que internamente utiliza un wxDataViewListStore y reenvía la mayor parte de su API a esa clase.
Jerarquía:
El propósito de esta clase es ofrecer una forma sencilla de mostrar y editar una pequeña tabla de datos sin tener que escribir un wxDataViewModel propio.
wxDataViewListCtrl *listctrl = new wxDataViewListCtrl( parent, wxID_ANY );
listctrl->AppendToggleColumn( "Toggle" );
listctrl->AppendTextColumn( "Text" );
wxVector<wxVariant> data;
data.push_back( wxVariant(true) );
data.push_back( wxVariant("row 1") );
listctrl->AppendItem( data );
data.clear();
data.push_back( wxVariant(false) );
data.push_back( wxVariant("row 3") );
listctrl->AppendItem( data );
Estilos
Esta clase soporta los mismos estilos que la clase wxDataViewCtrl.
Eventos emitidos por esta clase
Las macros de eventos para eventos emitidos por esta clase son las mismas que para wxDataViewCtrl.
Funciones miembro
wxDataViewListCtrl()
wxDataViewListCtrl::wxDataViewListCtrl()
Constructor por defeto.
wxDataViewListCtrl()
wxDataViewListCtrl::wxDataViewListCtrl( wxWindow * parent, wxWindowID id, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, long style = wxDV_ROW_LINES, const wxValidator & validator = wxDefaultValidator )
Constructor. Invoca a Create.
~wxDataViewListCtrl()
wxDataViewListCtrl::~wxDataViewListCtrl()
Destructor.
Borra la lista de imágenes, si existen.
AppendColumn()
virtual bool wxDataViewListCtrl::AppendColumn(wxDataViewColumn * column)
Añade una columna al control y adicionalmente añade una columna al almacén con el tipo string.
Reimplementado de wxDataViewCtrl.
AppendColumn()
void wxDataViewListCtrl::AppendColumn( wxDataViewColumn * column, const wxString & varianttype )
Añade una columna al control y, además, añade una columna al almacén de listas con el tipo varianttype.
AppendIconTextColumn()
wxDataViewColumn* wxDataViewListCtrl::AppendIconTextColumn( const wxString & label, wxDataViewCellMode mode = wxDATAVIEW_CELL_INERT, int width = wxCOL_WIDTH_DEFAULT, wxAlignment align = wxALIGN_LEFT, int flags = wxDATAVIEW_COL_RESIZABLE )
Añade una columna de iconos y texto al control y al almacén.
Ver wxDataViewColumn::wxDataViewColumn para más información sobre los parámetros.
AppendItem()
void wxDataViewListCtrl::AppendItem( const wxVector< wxVariant > & values, wxUIntPtr data = nullptr )
Añade un elemento (es decir, una fila) al control.
Hay que tener en cuenta que el tamaño del vector de valores debe ser exactamente igual al número de columnas del control y que las columnas no deben modificarse después de añadir ningún elemento al control (o, a la inversa, no deben añadirse elementos antes de configurar las columnas).
AppendProgressColumn()
wxDataViewColumn* wxDataViewListCtrl::AppendProgressColumn( const wxString & label, wxDataViewCellMode mode = wxDATAVIEW_CELL_INERT, int width = wxCOL_WIDTH_DEFAULT, wxAlignment align = wxALIGN_LEFT, int flags = wxDATAVIEW_COL_RESIZABLE )
Añade una columna de progreso al control y al almacén.
Ver wxDataViewColumn::wxDataViewColumn para más información sobre los parámetros.
AppendTextColumn()
wxDataViewColumn* wxDataViewListCtrl::AppendTextColumn( const wxString & label, wxDataViewCellMode mode = wxDATAVIEW_CELL_INERT, int width = wxCOL_WIDTH_DEFAULT, wxAlignment align = wxALIGN_LEFT, int flags = wxDATAVIEW_COL_RESIZABLE )
Añade una columna de texto al control y al almacén.
Ver wxDataViewColumn::wxDataViewColumn para más información sobre los parámetros.
AppendToggleColumn()
wxDataViewColumn* wxDataViewListCtrl::AppendToggleColumn( const wxString & label, wxDataViewCellMode mode = wxDATAVIEW_CELL_ACTIVATABLE, int width = wxCOL_WIDTH_DEFAULT, wxAlignment align = wxALIGN_LEFT, int flags = wxDATAVIEW_COL_RESIZABLE )
Añade una columna toggle al control y al almacén.
Ver wxDataViewColumn::wxDataViewColumn para más información sobre los parámetros.
Create()
bool wxDataViewListCtrl::Create( wxWindow * parent, wxWindowID id, const wxPoint & pos = wxDefaultPosition, const wxSize & size = wxDefaultSize, long style = wxDV_ROW_LINES, const wxValidator & validator = wxDefaultValidator )
Crea el control y un wxDataViewListStore como su modelo interno.
DeleteAllItems()
void wxDataViewListCtrl::DeleteAllItems()
Borrar todos los elementos (= todas las filas).
DeleteItem()
void wxDataViewListCtrl::DeleteItem(unsigned row)
Elimina la fila en la posición row.
GetItemCount()
unsigned int wxDataViewListCtrl::GetItemCount() const
Devuelve el número de elementos (=filas) del control.
GetItemData()
wxUIntPtr wxDataViewListCtrl::GetItemData(const wxDataViewItem & item) const
Devuelve los datos del cliente asociados al artículo.
GetSelectedRow()
int wxDataViewListCtrl::GetSelectedRow() const
Devuelve el índice de la fila seleccionada o wxNOT_FOUND.
GetStore()
wxDataViewListStore* wxDataViewListCtrl::GetStore()
Devuelve el almacén.
GetStore()
const wxDataViewListStore* wxDataViewListCtrl::GetStore() const
Devuelve el almacén.
GetTextValue()
wxString wxDataViewListCtrl::GetTextValue( unsigned int row, unsigned int col ) const
Devuelve el valor del almacén.
Este método asume que la cadena está almacenada en la columna respectiva.
GetToggleValue()
bool wxDataViewListCtrl::GetToggleValue( unsigned int row, unsigned int col ) const
Devuelve el valor del almacén.
Este método asume que el valor booleano está almacenado en la columna respectiva.
GetValue()
void wxDataViewListCtrl::GetValue( wxVariant & value, unsigned int row, unsigned int col )
Devuelve el valor del almacén.
InsertColumn()
virtual bool wxDataViewListCtrl::InsertColumn( unsigned int pos, wxDataViewColumn * column )
Inserta una columna en el control y adicionalmente inserta una columna en el almacén con el tipo string.
Reimplementado de wxDataViewCtrl.
InsertColumn()
void wxDataViewListCtrl::InsertColumn( unsigned int pos, wxDataViewColumn * column, const wxString & varianttype )
Inserta una columna en el control y, además, inserta una columna en el almacén de listas con el tipo varianttype.
InsertItem()
void wxDataViewListCtrl::InsertItem( unsigned int row, const wxVector< wxVariant > & values, wxUIntPtr data = nullptr )
Inserta un elemento (es decir, una fila) en el control.
Consultar las observaciones de AppendItem() para conocer las condiciones previas de este método.
Además, row debe ser menor o igual que el número actual de elementos del control (véase GetItemCount()).
IsRowSelected()
bool wxDataViewListCtrl::IsRowSelected(unsigned row) const
Devuelve true si la fila está seleccionada.
ItemToRow()
int wxDataViewListCtrl::ItemToRow(const wxDataViewItem & item) const
Devuelve la posición del elemento dado o wxNOT_FOUND si no es un elemento válido.
PrependColumn()
virtual bool wxDataViewListCtrl::PrependColumn(wxDataViewColumn * column)
Añade una columna al control y además añade una columna al almacén de tipo cadena.
Reimplementado de wxDataViewCtrl.
PrependColumn()
void wxDataViewListCtrl::PrependColumn( wxDataViewColumn * column, const wxString & varianttype )
Añade una columna al principio control y, además, añade una columna al almacén de listas con el tipo varianttype.
PrependItem()
void wxDataViewListCtrl::PrependItem( const wxVector< wxVariant > & values, wxUIntPtr data = nullptr )
Añade un elemento (es decir, una fila) al principio del control.
Consultar las observaciones de AppendItem() para conocer las condiciones previas de este método.
RowToItem()
wxDataViewItem wxDataViewListCtrl::RowToItem(int row) const
Devuelve el wxDataViewItem en la fila dada.
SelectRow()
void wxDataViewListCtrl::SelectRow(unsigned row)
Selecciona una fila determinada.
SetItemData()
void wxDataViewListCtrl::SetItemData( const wxDataViewItem & item, wxUIntPtr data )
Asocia un puntero de datos de cliente con el elemento dado.
Obsérvese que el control no se apropia del puntero por compatibilidad con wxListCtrl. Es decir, no borrará el puntero (si es un puntero y no un número) por sí mismo, es la aplicación quien debe hacerlo.
SetTextValue()
void wxDataViewListCtrl::SetTextValue( const wxString & value, unsigned int row, unsigned int col )
Establece el valor en el almacén y actualiza el control.
Este método asume que la cadena se almacena en la columna respectiva.
SetToggleValue()
void wxDataViewListCtrl::SetToggleValue( bool value, unsigned int row, unsigned int col )
Establece el valor en el almacén y actualiza el control.
Este método asume que el valor booleano se almacena en la columna respectiva.
SetValue()
void wxDataViewListCtrl::SetValue( const wxVariant & value, unsigned int row, unsigned int col )
Establece el valor en el almacén y actualiza el control.
UnselectRow()
void wxDataViewListCtrl::UnselectRow(unsigned row)
Deselecciona una fila determinada.
Métodos y datos heredados
Esta clase hereda los métodos y datos miembro públicos y protegidos de wxObject, wxEvtHandler, wxWindow, wxControl y wxDataViewCtrl.