Version: 3.3.0
wxDataViewListStore Class Reference

#include <wx/dataview.h>

+ Inheritance diagram for wxDataViewListStore:

Detailed Description

wxDataViewListStore is a specialised wxDataViewModel for storing a simple table of data.

Since it derives from wxDataViewIndexListModel its data is be accessed by row (i.e. by index) instead of only by wxDataViewItem.

This class actually stores the values (therefore its name) and implements all virtual methods from the base classes so it can be used directly without having to derive any class from it, but it is mostly used from within wxDataViewListCtrl.

Library:  wxCore
Category:  wxDataViewCtrl Related Classes

Public Member Functions

 wxDataViewListStore ()
 Constructor. More...
 
 ~wxDataViewListStore ()
 Destructor. More...
 
void PrependColumn (const wxString &varianttype)
 Prepends a data column. More...
 
void InsertColumn (unsigned int pos, const wxString &varianttype)
 Inserts a data column before pos. More...
 
void AppendColumn (const wxString &varianttype)
 Appends a data column. More...
 
void AppendItem (const wxVector< wxVariant > &values, wxUIntPtr data=nullptr)
 Appends an item (=row) and fills it with values. More...
 
void PrependItem (const wxVector< wxVariant > &values, wxUIntPtr data=nullptr)
 Prepends an item (=row) and fills it with values. More...
 
void InsertItem (unsigned int row, const wxVector< wxVariant > &values, wxUIntPtr data=nullptr)
 Inserts an item (=row) and fills it with values. More...
 
void DeleteItem (unsigned pos)
 Delete the item (=row) at position pos. More...
 
void DeleteAllItems ()
 Delete all item (=all rows) in the store. More...
 
unsigned int GetItemCount () const
 Returns the number of items (=rows) in the control. More...
 
wxUIntPtr GetItemData (const wxDataViewItem &item) const
 Returns the client data associated with the item. More...
 
void SetItemData (const wxDataViewItem &item, wxUIntPtr data)
 Sets the client data associated with the item. More...
 
virtual void GetValueByRow (wxVariant &value, unsigned int row, unsigned int col) const
 Overridden from wxDataViewIndexListModel. More...
 
virtual bool SetValueByRow (const wxVariant &value, unsigned int row, unsigned int col)
 Overridden from wxDataViewIndexListModel. More...
 
- Public Member Functions inherited from wxDataViewIndexListModel
 wxDataViewIndexListModel (unsigned int initial_size=0)
 Constructor. More...
 
wxDataViewItem GetItem (unsigned int row) const
 Returns the wxDataViewItem at the given row. More...
 
void Reset (unsigned int new_size)
 Call this after if the data has to be read again from the model. More...
 
void RowAppended ()
 Call this after a row has been appended to the model. More...
 
void RowChanged (unsigned int row)
 Call this after a row has been changed. More...
 
void RowDeleted (unsigned int row)
 Call this after a row has been deleted. More...
 
void RowInserted (unsigned int before)
 Call this after a row has been inserted at the given position. More...
 
void RowPrepended ()
 Call this after a row has been prepended to the model. More...
 
void RowValueChanged (unsigned int row, unsigned int col)
 Call this after a value has been changed. More...
 
void RowsDeleted (const wxArrayInt &rows)
 Call this after rows have been deleted. More...
 
- Public Member Functions inherited from wxDataViewListModel
virtual ~wxDataViewListModel ()
 Destructor. More...
 
int Compare (const wxDataViewItem &item1, const wxDataViewItem &item2, unsigned int column, bool ascending) const
 Compare method that sorts the items by their index. More...
 
virtual bool GetAttrByRow (unsigned int row, unsigned int col, wxDataViewItemAttr &attr) const
 Override this to indicate that the row has special font attributes. More...
 
virtual bool IsEnabledByRow (unsigned int row, unsigned int col) const
 Override this if you want to disable specific items. More...
 
unsigned int GetCount () const =0
 Returns the number of items (or rows) in the list. More...
 
unsigned int GetRow (const wxDataViewItem &item) const =0
 Returns the position of given item. More...
 
- Public Member Functions inherited from wxDataViewModel
 wxDataViewModel ()
 Constructor. More...
 
void AddNotifier (wxDataViewModelNotifier *notifier)
 Adds a wxDataViewModelNotifier to the model. More...
 
bool ChangeValue (const wxVariant &variant, const wxDataViewItem &item, unsigned int col)
 Change the value of the given item and update the control to reflect it. More...
 
bool Cleared ()
 Called to inform the model that all of its data has been changed. More...
 
virtual bool GetAttr (const wxDataViewItem &item, unsigned int col, wxDataViewItemAttr &attr) const
 Override this to indicate that the item has special font attributes. More...
 
virtual bool IsEnabled (const wxDataViewItem &item, unsigned int col) const
 Override this to indicate that the item should be disabled. More...
 
virtual unsigned int GetChildren (const wxDataViewItem &item, wxDataViewItemArray &children) const =0
 Override this so the control can query the child items of an item. More...
 
virtual wxDataViewItem GetParent (const wxDataViewItem &item) const =0
 Override this to indicate which wxDataViewItem representing the parent of item or an invalid wxDataViewItem if the root item is the parent item. More...
 
virtual void GetValue (wxVariant &variant, const wxDataViewItem &item, unsigned int col) const =0
 Override this to indicate the value of item. More...
 
virtual bool HasContainerColumns (const wxDataViewItem &item) const
 Override this method to indicate if a container item merely acts as a headline (or for categorisation) or if it also acts a normal item with entries for further columns. More...
 
virtual bool HasDefaultCompare () const
 Override this to indicate that the model provides a default compare function that the control should use if no wxDataViewColumn has been chosen for sorting. More...
 
virtual bool HasValue (const wxDataViewItem &item, unsigned col) const
 Return true if there is a value in the given column of this item. More...
 
virtual bool IsContainer (const wxDataViewItem &item) const =0
 Override this to indicate if item is a container, i.e. if it can have child items. More...
 
bool ItemAdded (const wxDataViewItem &parent, const wxDataViewItem &item)
 Call this to inform the model that an item has been added to the data. More...
 
bool ItemChanged (const wxDataViewItem &item)
 Call this to inform the model that an item has changed. More...
 
bool ItemDeleted (const wxDataViewItem &parent, const wxDataViewItem &item)
 Call this to inform the model that an item has been deleted from the data. More...
 
bool ItemsAdded (const wxDataViewItem &parent, const wxDataViewItemArray &items)
 Call this to inform the model that several items have been added to the data. More...
 
bool ItemsChanged (const wxDataViewItemArray &items)
 Call this to inform the model that several items have changed. More...
 
bool ItemsDeleted (const wxDataViewItem &parent, const wxDataViewItemArray &items)
 Call this to inform the model that several items have been deleted. More...
 
void RemoveNotifier (wxDataViewModelNotifier *notifier)
 Remove the notifier from the list of notifiers. More...
 
virtual void Resort ()
 Call this to initiate a resort after the sort function has been changed. More...
 
virtual bool SetValue (const wxVariant &variant, const wxDataViewItem &item, unsigned int col)=0
 This gets called in order to set a value in the data model. More...
 
bool ValueChanged (const wxDataViewItem &item, unsigned int col)
 Call this to inform this model that a value in the model has been changed. More...
 
virtual bool IsListModel () const
 
virtual bool IsVirtualListModel () const
 
- Public Member Functions inherited from wxRefCounter
 wxRefCounter ()
 Default constructor. More...
 
void DecRef ()
 Decrements the reference count associated with this shared data and, if it reaches zero, destroys this instance of wxRefCounter releasing its memory. More...
 
int GetRefCount () const
 Returns the reference count associated with this shared data. More...
 
void IncRef ()
 Increments the reference count associated with this shared data. More...
 

Additional Inherited Members

- Protected Member Functions inherited from wxDataViewModel
virtual ~wxDataViewModel ()
 Destructor. More...
 
virtual int DoCompareValues (const wxVariant &value1, const wxVariant &value2) const
 Virtual method that can be overridden to define comparison for values of non-standard types. More...
 
- Protected Member Functions inherited from wxRefCounter
virtual ~wxRefCounter ()
 Destructor. More...
 

Constructor & Destructor Documentation

◆ wxDataViewListStore()

wxDataViewListStore::wxDataViewListStore ( )

Constructor.

◆ ~wxDataViewListStore()

wxDataViewListStore::~wxDataViewListStore ( )

Destructor.

Member Function Documentation

◆ AppendColumn()

void wxDataViewListStore::AppendColumn ( const wxString varianttype)

Appends a data column.

variantype indicates the type of values store in the column.

This does not automatically fill in any (default) values in rows which exist in the store already.

◆ AppendItem()

void wxDataViewListStore::AppendItem ( const wxVector< wxVariant > &  values,
wxUIntPtr  data = nullptr 
)

Appends an item (=row) and fills it with values.

The values must match the values specifies in the column in number and type. No (default) values are filled in automatically.

◆ DeleteAllItems()

void wxDataViewListStore::DeleteAllItems ( )

Delete all item (=all rows) in the store.

◆ DeleteItem()

void wxDataViewListStore::DeleteItem ( unsigned  pos)

Delete the item (=row) at position pos.

◆ GetItemCount()

unsigned int wxDataViewListStore::GetItemCount ( ) const

Returns the number of items (=rows) in the control.

Since
2.9.4

◆ GetItemData()

wxUIntPtr wxDataViewListStore::GetItemData ( const wxDataViewItem item) const

Returns the client data associated with the item.

See also
SetItemData()
Since
2.9.4

◆ GetValueByRow()

virtual void wxDataViewListStore::GetValueByRow ( wxVariant value,
unsigned int  row,
unsigned int  col 
) const
virtual

Overridden from wxDataViewIndexListModel.

Implements wxDataViewListModel.

◆ InsertColumn()

void wxDataViewListStore::InsertColumn ( unsigned int  pos,
const wxString varianttype 
)

Inserts a data column before pos.

variantype indicates the type of values store in the column.

This does not automatically fill in any (default) values in rows which exist in the store already.

◆ InsertItem()

void wxDataViewListStore::InsertItem ( unsigned int  row,
const wxVector< wxVariant > &  values,
wxUIntPtr  data = nullptr 
)

Inserts an item (=row) and fills it with values.

The values must match the values specifies in the column in number and type. No (default) values are filled in automatically.

◆ PrependColumn()

void wxDataViewListStore::PrependColumn ( const wxString varianttype)

Prepends a data column.

variantype indicates the type of values store in the column.

This does not automatically fill in any (default) values in rows which exist in the store already.

◆ PrependItem()

void wxDataViewListStore::PrependItem ( const wxVector< wxVariant > &  values,
wxUIntPtr  data = nullptr 
)

Prepends an item (=row) and fills it with values.

The values must match the values specifies in the column in number and type. No (default) values are filled in automatically.

◆ SetItemData()

void wxDataViewListStore::SetItemData ( const wxDataViewItem item,
wxUIntPtr  data 
)

Sets the client data associated with the item.

Notice that this class does not take ownership of the passed in pointer and will not delete it.

See also
GetItemData()
Since
2.9.4

◆ SetValueByRow()

virtual bool wxDataViewListStore::SetValueByRow ( const wxVariant value,
unsigned int  row,
unsigned int  col 
)
virtual

Overridden from wxDataViewIndexListModel.

Implements wxDataViewListModel.