Version: 3.2.8
dataview.h File Reference

Classes

class  wxDataViewModel
 

wxDataViewModel is the base class for all data model to be displayed by a
wxDataViewCtrl.
More...
 
class  wxDataViewListModel
 

Base class with abstract API for wxDataViewIndexListModel and
wxDataViewVirtualListModel.
More...
 
class  wxDataViewIndexListModel
 

wxDataViewIndexListModel is a specialized data model which lets you address
an item by its position (row) rather than its wxDataViewItem (which you can
obtain from this class).
More...
 
class  wxDataViewVirtualListModel
 

wxDataViewVirtualListModel is a specialized data model which lets you address
an item by its position (row) rather than its wxDataViewItem and as such offers
the exact same interface as wxDataViewIndexListModel.
More...
 
class  wxDataViewItemAttr
 

This class is used to indicate to a wxDataViewCtrl that a certain item
(see wxDataViewItem) has extra font attributes for its renderer.
More...
 
class  wxDataViewItem
 

wxDataViewItem is a small opaque class that represents an item in a wxDataViewCtrl
in a persistent way, i.e.
More...
 
class  wxDataViewCtrl
 

wxDataViewCtrl is a control to display data either in a tree like fashion or
in a tabular form or both.
More...
 
class  wxDataViewModelNotifier
 

A wxDataViewModelNotifier instance is owned by a wxDataViewModel and mirrors
its notification interface.
More...
 
class  wxDataViewRenderer
 

This class is used by wxDataViewCtrl to render the individual cells.
More...
 
class  wxDataViewTextRenderer
 

wxDataViewTextRenderer is used for rendering text.
More...
 
class  wxDataViewIconTextRenderer
 

The wxDataViewIconTextRenderer class is used to display text with
a small icon next to it as it is typically done in a file manager.
More...
 
class  wxDataViewCheckIconTextRenderer
 
This renderer class shows a checkbox in addition to the icon and text shown by the base class and also allows the user to toggle this checkbox. More...
 
class  wxDataViewProgressRenderer
 

This class is used by wxDataViewCtrl to render progress bars.
More...
 
class  wxDataViewSpinRenderer
 

This is a specialized renderer for rendering integer values.
More...
 
class  wxDataViewToggleRenderer
 

This class is used by wxDataViewCtrl to render toggle controls.
More...
 
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
 

This class is used by wxDataViewCtrl to render calendar controls.
More...
 
class  wxDataViewCustomRenderer
 

You need to derive a new class from wxDataViewCustomRenderer in
order to write a new renderer.
More...
 
class  wxDataViewBitmapRenderer
 

This class is used by wxDataViewCtrl to render bitmaps.
More...
 
class  wxDataViewColumn
 

This class represents a column in a wxDataViewCtrl.
More...
 
class  wxDataViewListCtrl
 

This class is a wxDataViewCtrl which internally uses a wxDataViewListStore
and forwards most of its API to that class.
More...
 
class  wxDataViewTreeCtrl
 

This class is a wxDataViewCtrl which internally uses a wxDataViewTreeStore
and forwards most of its API to that class.
More...
 
class  wxDataViewListStore
 

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

wxDataViewTreeStore is a specialised wxDataViewModel for storing simple
trees very much like wxTreeCtrl does and it offers a similar API.
More...
 
class  wxDataViewIconText
 

wxDataViewIconText is used by wxDataViewIconTextRenderer for data transfer.
More...
 
class  wxDataViewCheckIconText
 

wxDataViewCheckIconText is used by wxDataViewCheckIconTextRenderer for data
transfer.
More...
 
class  wxDataViewEvent
 

This is the event class for the wxDataViewCtrl notifications.
More...
 
class  wxDataViewValueAdjuster
 

This class can be used with wxDataViewRenderer::SetValueAdjuster() to
customize rendering of model values with standard renderers.
More...
 

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