Version: 3.0.5
dataview.h File Reference

Classes

class  wxDataViewModel
 
class  wxDataViewListModel
 
class  wxDataViewIndexListModel
 
class  wxDataViewVirtualListModel
 
class  wxDataViewItemAttr
 
class  wxDataViewItem
 
class  wxDataViewCtrl
 
class  wxDataViewModelNotifier
 
class  wxDataViewRenderer
 
class  wxDataViewTextRenderer
 
class  wxDataViewIconTextRenderer
 
class  wxDataViewProgressRenderer
 
class  wxDataViewSpinRenderer
 
class  wxDataViewToggleRenderer
 
class  wxDataViewChoiceRenderer
 A wxDataViewCtrl renderer using wxChoice control and values of strings in it. More...
 
class  wxDataViewChoiceByIndexRenderer
 A wxDataViewCtrl renderer using wxChoice control and indexes into it. More...
 
class  wxDataViewDateRenderer
 
class  wxDataViewCustomRenderer
 
class  wxDataViewBitmapRenderer
 
class  wxDataViewColumn
 
class  wxDataViewListCtrl
 
class  wxDataViewTreeCtrl
 
class  wxDataViewListStore
 
class  wxDataViewTreeStore
 
class  wxDataViewIconText
 
class  wxDataViewEvent
 

Macros

#define wxDVC_DEFAULT_RENDERER_SIZE   20
 
#define wxDVC_DEFAULT_WIDTH   80
 
#define wxDVC_TOGGLE_DEFAULT_WIDTH   30
 
#define wxDVC_DEFAULT_MINWIDTH   30
 
#define wxDVR_DEFAULT_ALIGNMENT   -1
 
#define wxDV_SINGLE   0x0000
 
#define wxDV_MULTIPLE   0x0001
 
#define wxDV_NO_HEADER   0x0002
 
#define wxDV_HORIZ_RULES   0x0004
 
#define wxDV_VERT_RULES   0x0008
 
#define wxDV_ROW_LINES   0x0010
 
#define wxDV_VARIABLE_LINE_HEIGHT   0x0020
 

Enumerations

enum  wxDataViewCellMode {
  wxDATAVIEW_CELL_INERT,
  wxDATAVIEW_CELL_ACTIVATABLE,
  wxDATAVIEW_CELL_EDITABLE
}
 The mode of a data-view cell; see wxDataViewRenderer for more info. More...
 
enum  wxDataViewCellRenderState {
  wxDATAVIEW_CELL_SELECTED = 1,
  wxDATAVIEW_CELL_PRELIT = 2,
  wxDATAVIEW_CELL_INSENSITIVE = 4,
  wxDATAVIEW_CELL_FOCUSED = 8
}
 The values of this enum controls how a wxDataViewRenderer should display its contents in a cell. More...
 
enum  wxDataViewColumnFlags {
  wxDATAVIEW_COL_RESIZABLE = 1,
  wxDATAVIEW_COL_SORTABLE = 2,
  wxDATAVIEW_COL_REORDERABLE = 4,
  wxDATAVIEW_COL_HIDDEN = 8
}
 The flags used by wxDataViewColumn. More...
 

Variables

wxEventType wxEVT_DATAVIEW_SELECTION_CHANGED
 
wxEventType wxEVT_DATAVIEW_ITEM_ACTIVATED
 
wxEventType wxEVT_DATAVIEW_ITEM_COLLAPSING
 
wxEventType wxEVT_DATAVIEW_ITEM_COLLAPSED
 
wxEventType wxEVT_DATAVIEW_ITEM_EXPANDING
 
wxEventType wxEVT_DATAVIEW_ITEM_EXPANDED
 
wxEventType wxEVT_DATAVIEW_ITEM_START_EDITING
 
wxEventType wxEVT_DATAVIEW_ITEM_EDITING_STARTED
 
wxEventType wxEVT_DATAVIEW_ITEM_EDITING_DONE
 
wxEventType wxEVT_DATAVIEW_ITEM_VALUE_CHANGED
 
wxEventType wxEVT_DATAVIEW_ITEM_CONTEXT_MENU
 
wxEventType wxEVT_DATAVIEW_COLUMN_HEADER_CLICK
 
wxEventType wxEVT_DATAVIEW_COLUMN_HEADER_RIGHT_CLICK
 
wxEventType wxEVT_DATAVIEW_COLUMN_SORTED
 
wxEventType wxEVT_DATAVIEW_COLUMN_REORDERED
 
wxEventType wxEVT_DATAVIEW_CACHE_HINT
 
wxEventType wxEVT_DATAVIEW_ITEM_BEGIN_DRAG
 
wxEventType wxEVT_DATAVIEW_ITEM_DROP_POSSIBLE
 
wxEventType wxEVT_DATAVIEW_ITEM_DROP
 

Macro Definition Documentation

◆ wxDV_HORIZ_RULES

#define wxDV_HORIZ_RULES   0x0004

◆ wxDV_MULTIPLE

#define wxDV_MULTIPLE   0x0001

◆ wxDV_NO_HEADER

#define wxDV_NO_HEADER   0x0002

◆ wxDV_ROW_LINES

#define wxDV_ROW_LINES   0x0010

◆ wxDV_SINGLE

#define wxDV_SINGLE   0x0000

◆ wxDV_VARIABLE_LINE_HEIGHT

#define wxDV_VARIABLE_LINE_HEIGHT   0x0020

◆ wxDV_VERT_RULES

#define wxDV_VERT_RULES   0x0008

◆ wxDVC_DEFAULT_MINWIDTH

#define wxDVC_DEFAULT_MINWIDTH   30

◆ wxDVC_DEFAULT_RENDERER_SIZE

#define wxDVC_DEFAULT_RENDERER_SIZE   20

◆ wxDVC_DEFAULT_WIDTH

#define wxDVC_DEFAULT_WIDTH   80

◆ wxDVC_TOGGLE_DEFAULT_WIDTH

#define wxDVC_TOGGLE_DEFAULT_WIDTH   30

◆ wxDVR_DEFAULT_ALIGNMENT

#define wxDVR_DEFAULT_ALIGNMENT   -1

Enumeration Type Documentation

◆ wxDataViewCellMode

The mode of a data-view cell; see wxDataViewRenderer for more info.

Enumerator
wxDATAVIEW_CELL_INERT 

The cell only displays information and cannot be manipulated or otherwise interacted with in any way.

Note that this doesn't mean that the row being drawn can't be selected, just that a particular element of it cannot be individually modified.

wxDATAVIEW_CELL_ACTIVATABLE 

Indicates that the cell can be activated by clicking it or using keyboard.

Activating a cell is an alternative to showing inline editor when the value can be edited in a simple way that doesn't warrant full editor control. The most typical use of cell activation is toggling the checkbox in wxDataViewToggleRenderer; others would be e.g. an embedded volume slider or a five-star rating column.

The exact means of activating a cell are platform-dependent, but they are usually similar to those used for inline editing of values. Typically, a cell would be activated by Space or Enter keys or by left mouse click.

Note
Do not confuse this with item activation in wxDataViewCtrl and the wxEVT_DATAVIEW_ITEM_ACTIVATED event. That one is used for activating the item (or, to put it differently, the entire row) similarly to analogous messages in wxTreeCtrl and wxListCtrl, and the effect differs (play a song, open a file etc.). Cell activation, on the other hand, is all about interacting with the individual cell.
See also
wxDataViewCustomRenderer::ActivateCell()
wxDATAVIEW_CELL_EDITABLE 

Indicates that the user can edit the data in-place in an inline editor control that will show up when the user wants to edit the cell.

A typical example of this behaviour is changing the filename in a file managers.

Editing is typically triggered by slowly double-clicking the cell or by a platform-dependent keyboard shortcut (F2 is typical on Windows, Space and/or Enter is common elsewhere and supported on Windows too).

See also
wxDataViewCustomRenderer::CreateEditorCtrl()

◆ wxDataViewCellRenderState

The values of this enum controls how a wxDataViewRenderer should display its contents in a cell.

Enumerator
wxDATAVIEW_CELL_SELECTED 
wxDATAVIEW_CELL_PRELIT 
wxDATAVIEW_CELL_INSENSITIVE 
wxDATAVIEW_CELL_FOCUSED 

◆ wxDataViewColumnFlags

The flags used by wxDataViewColumn.

Can be combined together.

Enumerator
wxDATAVIEW_COL_RESIZABLE 
wxDATAVIEW_COL_SORTABLE 
wxDATAVIEW_COL_REORDERABLE 
wxDATAVIEW_COL_HIDDEN 

Variable Documentation

◆ wxEVT_DATAVIEW_CACHE_HINT

wxEventType wxEVT_DATAVIEW_CACHE_HINT

◆ wxEVT_DATAVIEW_COLUMN_HEADER_CLICK

wxEventType wxEVT_DATAVIEW_COLUMN_HEADER_CLICK

◆ wxEVT_DATAVIEW_COLUMN_HEADER_RIGHT_CLICK

wxEventType wxEVT_DATAVIEW_COLUMN_HEADER_RIGHT_CLICK

◆ wxEVT_DATAVIEW_COLUMN_REORDERED

wxEventType wxEVT_DATAVIEW_COLUMN_REORDERED

◆ wxEVT_DATAVIEW_COLUMN_SORTED

wxEventType wxEVT_DATAVIEW_COLUMN_SORTED

◆ wxEVT_DATAVIEW_ITEM_ACTIVATED

wxEventType wxEVT_DATAVIEW_ITEM_ACTIVATED

◆ wxEVT_DATAVIEW_ITEM_BEGIN_DRAG

wxEventType wxEVT_DATAVIEW_ITEM_BEGIN_DRAG

◆ wxEVT_DATAVIEW_ITEM_COLLAPSED

wxEventType wxEVT_DATAVIEW_ITEM_COLLAPSED

◆ wxEVT_DATAVIEW_ITEM_COLLAPSING

wxEventType wxEVT_DATAVIEW_ITEM_COLLAPSING

◆ wxEVT_DATAVIEW_ITEM_CONTEXT_MENU

wxEventType wxEVT_DATAVIEW_ITEM_CONTEXT_MENU

◆ wxEVT_DATAVIEW_ITEM_DROP

wxEventType wxEVT_DATAVIEW_ITEM_DROP

◆ wxEVT_DATAVIEW_ITEM_DROP_POSSIBLE

wxEventType wxEVT_DATAVIEW_ITEM_DROP_POSSIBLE

◆ wxEVT_DATAVIEW_ITEM_EDITING_DONE

wxEventType wxEVT_DATAVIEW_ITEM_EDITING_DONE

◆ wxEVT_DATAVIEW_ITEM_EDITING_STARTED

wxEventType wxEVT_DATAVIEW_ITEM_EDITING_STARTED

◆ wxEVT_DATAVIEW_ITEM_EXPANDED

wxEventType wxEVT_DATAVIEW_ITEM_EXPANDED

◆ wxEVT_DATAVIEW_ITEM_EXPANDING

wxEventType wxEVT_DATAVIEW_ITEM_EXPANDING

◆ wxEVT_DATAVIEW_ITEM_START_EDITING

wxEventType wxEVT_DATAVIEW_ITEM_START_EDITING

◆ wxEVT_DATAVIEW_ITEM_VALUE_CHANGED

wxEventType wxEVT_DATAVIEW_ITEM_VALUE_CHANGED

◆ wxEVT_DATAVIEW_SELECTION_CHANGED

wxEventType wxEVT_DATAVIEW_SELECTION_CHANGED