]> git.saurik.com Git - wxWidgets.git/blame - include/wx/dataview.h
process one event at once in wxEvtHandler::ProcessPendingEvents() to prevent crashes...
[wxWidgets.git] / include / wx / dataview.h
CommitLineData
bcd846ea
RR
1/////////////////////////////////////////////////////////////////////////////
2// Name: wx/dataview.h
3// Purpose: wxDataViewCtrl base classes
4// Author: Robert Roebling
b7e9f8b1 5// Modified by: Bo Yang
bcd846ea
RR
6// Created: 08.01.06
7// RCS-ID: $Id$
8// Copyright: (c) Robert Roebling
9// Licence: wxWindows licence
10/////////////////////////////////////////////////////////////////////////////
11
12#ifndef _WX_DATAVIEW_H_BASE_
13#define _WX_DATAVIEW_H_BASE_
14
15#include "wx/defs.h"
16
17#if wxUSE_DATAVIEWCTRL
18
239eaa41
RR
19#include "wx/control.h"
20#include "wx/textctrl.h"
21#include "wx/bitmap.h"
64ffb888 22#include "wx/variant.h"
b7e9f8b1 23#include "wx/dynarray.h"
89352653 24#include "wx/icon.h"
a75124d0 25#include "wx/imaglist.h"
4ed7af08 26
5e6f8927
PC
27class WXDLLIMPEXP_FWD_CORE wxDataFormat;
28
4ed7af08
RR
29#if defined(__WXGTK20__)
30 // for testing
001f0f82 31 // #define wxUSE_GENERICDATAVIEWCTRL 1
4ed7af08 32#elif defined(__WXMAC__)
4ed7af08
RR
33#else
34 #define wxUSE_GENERICDATAVIEWCTRL 1
35#endif
36
bcd846ea 37// ----------------------------------------------------------------------------
f554a14b 38// wxDataViewCtrl flags
bcd846ea
RR
39// ----------------------------------------------------------------------------
40
239eaa41
RR
41// ----------------------------------------------------------------------------
42// wxDataViewCtrl globals
43// ----------------------------------------------------------------------------
bcd846ea 44
b5dbe15d
VS
45class WXDLLIMPEXP_FWD_ADV wxDataViewItem;
46class WXDLLIMPEXP_FWD_ADV wxDataViewModel;
47class WXDLLIMPEXP_FWD_ADV wxDataViewCtrl;
48class WXDLLIMPEXP_FWD_ADV wxDataViewColumn;
49class WXDLLIMPEXP_FWD_ADV wxDataViewRenderer;
50class WXDLLIMPEXP_FWD_ADV wxDataViewModelNotifier;
fa28826d 51
f460c29d 52extern WXDLLIMPEXP_DATA_ADV(const wxChar) wxDataViewCtrlNameStr[];
bcd846ea 53
87f0efe2
RR
54// the default width of new (text) columns:
55#define wxDVC_DEFAULT_WIDTH 80
56
57// the default width of new toggle columns:
58#define wxDVC_TOGGLE_DEFAULT_WIDTH 30
59
9861f022
RR
60// the default minimal width of the columns:
61#define wxDVC_DEFAULT_MINWIDTH 30
62
63// the default alignment of wxDataViewRenderers:
69357fa0 64#define wxDVR_DEFAULT_ALIGNMENT (wxALIGN_LEFT|wxALIGN_CENTRE_VERTICAL)
9861f022 65
87f0efe2 66
f554a14b 67// ---------------------------------------------------------
e0062c04 68// wxDataViewItem
f554a14b 69// ---------------------------------------------------------
239eaa41 70
e0062c04 71class WXDLLIMPEXP_ADV wxDataViewItem
239eaa41
RR
72{
73public:
b5ec7dd6 74 wxDataViewItem( void* id = NULL )
9d52aad3 75 { m_id = id; }
e0062c04 76 wxDataViewItem( const wxDataViewItem &item )
9d52aad3
RR
77 { m_id = item.m_id; }
78 bool IsOk() const { return m_id != NULL; }
79 void* GetID() const { return m_id; }
4f1cf94b 80 operator const void* () const { return m_id; }
b5ec7dd6 81
e94d0c1e 82#ifdef __WXDEBUG__
c3c62822 83 void Print( const wxString &text ) const;
e94d0c1e 84#endif
b5ec7dd6 85
8f850e28 86private:
9d52aad3 87 void* m_id;
64ffb888 88};
239eaa41 89
d5025dc0 90bool operator == (const wxDataViewItem &left, const wxDataViewItem &right);
aba9bfd0 91
cd722937
RR
92WX_DEFINE_ARRAY(wxDataViewItem, wxDataViewItemArray);
93
9d8fe14a
RR
94// ---------------------------------------------------------
95// wxDataViewModelNotifier
96// ---------------------------------------------------------
97
98class WXDLLIMPEXP_ADV wxDataViewModelNotifier
99{
100public:
5e6f8927 101 wxDataViewModelNotifier() { m_owner = NULL; }
9d8fe14a
RR
102 virtual ~wxDataViewModelNotifier() { m_owner = NULL; }
103
104 virtual bool ItemAdded( const wxDataViewItem &parent, const wxDataViewItem &item ) = 0;
105 virtual bool ItemDeleted( const wxDataViewItem &parent, const wxDataViewItem &item ) = 0;
106 virtual bool ItemChanged( const wxDataViewItem &item ) = 0;
854cdb09
RR
107 virtual bool ItemsAdded( const wxDataViewItem &parent, const wxDataViewItemArray &items );
108 virtual bool ItemsDeleted( const wxDataViewItem &parent, const wxDataViewItemArray &items );
109 virtual bool ItemsChanged( const wxDataViewItemArray &items );
9d8fe14a
RR
110 virtual bool ValueChanged( const wxDataViewItem &item, unsigned int col ) = 0;
111 virtual bool Cleared() = 0;
b5ec7dd6 112
d3f00f59 113 virtual void Resort() = 0;
9d8fe14a
RR
114
115 void SetOwner( wxDataViewModel *owner ) { m_owner = owner; }
116 wxDataViewModel *GetOwner() { return m_owner; }
117
118private:
119 wxDataViewModel *m_owner;
120};
121
122
4264606e
RR
123
124// ----------------------------------------------------------------------------
125// wxDataViewItemAttr: a structure containing the visual attributes of an item
126// ----------------------------------------------------------------------------
127
128// TODO: this should be renamed to wxItemAttr or something general like this
129
130class WXDLLIMPEXP_ADV wxDataViewItemAttr
131{
132public:
133 // ctors
134 wxDataViewItemAttr()
135 {
136 m_bold = false;
137 m_italic = false;
138 }
139
140 // setters
141 void SetColour(const wxColour& colour) { m_colour = colour; }
142 void SetBold( bool set ) { m_bold = set; }
143 void SetItalic( bool set ) { m_italic = set; }
144
145 // accessors
146 bool HasColour() const { return m_colour.Ok(); }
147 const wxColour& GetColour() const { return m_colour; }
148
149 bool GetBold() const { return m_bold; }
150 bool GetItalic() const { return m_italic; }
151
152private:
153 wxColour m_colour;
154 bool m_bold;
155 bool m_italic;
156};
157
158
f554a14b 159// ---------------------------------------------------------
e0062c04 160// wxDataViewModel
f554a14b 161// ---------------------------------------------------------
239eaa41 162
d350fbec
VS
163WX_DECLARE_LIST_WITH_DECL(wxDataViewModelNotifier, wxDataViewModelNotifiers,
164 class WXDLLIMPEXP_ADV);
9d8fe14a 165
e0062c04 166class WXDLLIMPEXP_ADV wxDataViewModel: public wxObjectRefData
239eaa41
RR
167{
168public:
e0062c04 169 wxDataViewModel();
239eaa41 170
9861f022 171 virtual unsigned int GetColumnCount() const = 0;
87f0efe2 172
a7f61f76 173 // return type as reported by wxVariant
9861f022 174 virtual wxString GetColumnType( unsigned int col ) const = 0;
87f0efe2 175
a7f61f76 176 // get value into a wxVariant
b5ec7dd6 177 virtual void GetValue( wxVariant &variant,
e0062c04 178 const wxDataViewItem &item, unsigned int col ) const = 0;
87f0efe2 179
a7f61f76 180 // set value, call ValueChanged() afterwards!
b5ec7dd6 181 virtual bool SetValue( const wxVariant &variant,
e0062c04 182 const wxDataViewItem &item, unsigned int col ) = 0;
239eaa41 183
4264606e
RR
184 // Get text attribute, return false of default attributes should be used
185 virtual bool GetAttr( const wxDataViewItem &WXUNUSED(item), unsigned int WXUNUSED(col), wxDataViewItemAttr &WXUNUSED(attr) )
186 { return false; }
187
e0062c04 188 // define hierachy
ed903e42
RR
189 virtual wxDataViewItem GetParent( const wxDataViewItem &item ) const = 0;
190 virtual bool IsContainer( const wxDataViewItem &item ) const = 0;
1e40f667 191 // Is the container just a header or an item with all columns
b5ec7dd6
VZ
192 virtual bool HasContainerColumns(const wxDataViewItem& WXUNUSED(item)) const
193 { return false; }
74fe973b 194 virtual unsigned int GetChildren( const wxDataViewItem &item, wxDataViewItemArray &children ) const = 0;
b9b8b59c 195
f6f0ef85
RR
196 // define DnD capabilities
197 virtual bool IsDraggable( const wxDataViewItem &WXUNUSED(item) )
198 { return false; }
199 virtual size_t GetDragDataSize( const wxDataViewItem &WXUNUSED(item), const wxDataFormat &WXUNUSED(format) )
200 { return 0; }
201 virtual bool GetDragData( const wxDataViewItem &WXUNUSED(item), const wxDataFormat &WXUNUSED(format),
202 void* WXUNUSED(data), size_t WXUNUSED(size) )
203 { return FALSE; }
204
239eaa41 205 // delegated notifiers
e0062c04 206 virtual bool ItemAdded( const wxDataViewItem &parent, const wxDataViewItem &item );
854cdb09 207 virtual bool ItemsAdded( const wxDataViewItem &parent, const wxDataViewItemArray &items );
469d3e9b 208 virtual bool ItemDeleted( const wxDataViewItem &parent, const wxDataViewItem &item );
854cdb09 209 virtual bool ItemsDeleted( const wxDataViewItem &parent, const wxDataViewItemArray &items );
e0062c04 210 virtual bool ItemChanged( const wxDataViewItem &item );
854cdb09 211 virtual bool ItemsChanged( const wxDataViewItemArray &items );
e0062c04 212 virtual bool ValueChanged( const wxDataViewItem &item, unsigned int col );
8981608c 213 virtual bool Cleared();
b5d777c7 214
ef427989
RR
215 // delegatd action
216 virtual void Resort();
217
e0062c04
RR
218 void AddNotifier( wxDataViewModelNotifier *notifier );
219 void RemoveNotifier( wxDataViewModelNotifier *notifier );
b5ec7dd6 220
ef427989 221 // default compare function
b5ec7dd6 222 virtual int Compare( const wxDataViewItem &item1, const wxDataViewItem &item2,
7ee7191c 223 unsigned int column, bool ascending );
09711964 224 virtual bool HasDefaultCompare() const { return false; }
2056dede
RR
225
226 // internal
227 virtual bool IsIndexListModel() const { return false; }
66e09788 228
87f0efe2
RR
229protected:
230 // the user should not delete this class directly: he should use DecRef() instead!
5debbdcf 231 virtual ~wxDataViewModel() { }
87f0efe2 232
9d8fe14a 233 wxDataViewModelNotifiers m_notifiers;
ef427989
RR
234};
235
236// ---------------------------------------------------------
c534e696 237// wxDataViewIndexListModel
ef427989
RR
238// ---------------------------------------------------------
239
d350fbec 240class WXDLLIMPEXP_ADV wxDataViewIndexListModel: public wxDataViewModel
ef427989
RR
241{
242public:
c534e696 243 wxDataViewIndexListModel( unsigned int initial_size = 0 );
ef427989 244 ~wxDataViewIndexListModel();
b5ec7dd6 245
b5ec7dd6 246 virtual void GetValue( wxVariant &variant,
ef427989
RR
247 unsigned int row, unsigned int col ) const = 0;
248
b5ec7dd6 249 virtual bool SetValue( const wxVariant &variant,
ef427989 250 unsigned int row, unsigned int col ) = 0;
b5ec7dd6 251
4264606e
RR
252 virtual bool GetAttr( unsigned int WXUNUSED(row), unsigned int WXUNUSED(col), wxDataViewItemAttr &WXUNUSED(attr) )
253 { return false; }
254
c534e696
RR
255 void RowPrepended();
256 void RowInserted( unsigned int before );
257 void RowAppended();
258 void RowDeleted( unsigned int row );
8b6cf9bf 259 void RowsDeleted( const wxArrayInt &rows );
c534e696
RR
260 void RowChanged( unsigned int row );
261 void RowValueChanged( unsigned int row, unsigned int col );
33ba5a05 262 void Reset( unsigned int new_size );
b5ec7dd6 263
c534e696 264 // convert to/from row/wxDataViewItem
b5ec7dd6 265
c534e696
RR
266 unsigned int GetRow( const wxDataViewItem &item ) const;
267 wxDataViewItem GetItem( unsigned int row ) const;
b5ec7dd6 268
c534e696 269 // compare based on index
b5ec7dd6
VZ
270
271 virtual int Compare( const wxDataViewItem &item1, const wxDataViewItem &item2,
7ee7191c 272 unsigned int column, bool ascending );
517166e6 273 virtual bool HasDefaultCompare() const;
c534e696
RR
274
275 // implement base methods
276
b5ec7dd6 277 virtual void GetValue( wxVariant &variant,
c534e696 278 const wxDataViewItem &item, unsigned int col ) const;
b5ec7dd6 279 virtual bool SetValue( const wxVariant &variant,
c534e696 280 const wxDataViewItem &item, unsigned int col );
4264606e 281 virtual bool GetAttr( const wxDataViewItem &item, unsigned int col, wxDataViewItemAttr &attr );
c534e696
RR
282 virtual wxDataViewItem GetParent( const wxDataViewItem &item ) const;
283 virtual bool IsContainer( const wxDataViewItem &item ) const;
74fe973b 284 virtual unsigned int GetChildren( const wxDataViewItem &item, wxDataViewItemArray &children ) const;
b5ec7dd6 285
2056dede
RR
286 // internal
287 virtual bool IsIndexListModel() const { return true; }
288 unsigned int GetLastIndex() const { return m_lastIndex; }
289
c534e696 290private:
cd722937 291 wxDataViewItemArray m_hash;
c534e696 292 unsigned int m_lastIndex;
517166e6 293 bool m_ordered;
2056dede 294 bool m_useHash;
239eaa41
RR
295};
296
c33edc08 297
1e510b1e
RR
298//-----------------------------------------------------------------------------
299// wxDataViewEditorCtrlEvtHandler
300//-----------------------------------------------------------------------------
301
302class wxDataViewEditorCtrlEvtHandler: public wxEvtHandler
303{
304public:
305 wxDataViewEditorCtrlEvtHandler( wxControl *editor, wxDataViewRenderer *owner );
b5ec7dd6 306
1e510b1e 307 void AcceptChangesAndFinish();
30715fa1 308 void SetFocusOnIdle( bool focus = true ) { m_focusOnIdle = focus; }
1e510b1e
RR
309
310protected:
311 void OnChar( wxKeyEvent &event );
312 void OnKillFocus( wxFocusEvent &event );
30715fa1 313 void OnIdle( wxIdleEvent &event );
1e510b1e
RR
314
315private:
316 wxDataViewRenderer *m_owner;
317 wxControl *m_editorCtrl;
318 bool m_finished;
30715fa1 319 bool m_focusOnIdle;
1e510b1e
RR
320
321private:
322 DECLARE_EVENT_TABLE()
323};
324
f554a14b 325// ---------------------------------------------------------
baa9ebc4 326// wxDataViewRendererBase
f554a14b 327// ---------------------------------------------------------
fa28826d 328
6842a71a 329enum wxDataViewCellMode
fa28826d 330{
6842a71a
RR
331 wxDATAVIEW_CELL_INERT,
332 wxDATAVIEW_CELL_ACTIVATABLE,
333 wxDATAVIEW_CELL_EDITABLE
fa28826d
RR
334};
335
6842a71a
RR
336enum wxDataViewCellRenderState
337{
338 wxDATAVIEW_CELL_SELECTED = 1,
339 wxDATAVIEW_CELL_PRELIT = 2,
340 wxDATAVIEW_CELL_INSENSITIVE = 4,
341 wxDATAVIEW_CELL_FOCUSED = 8
342};
343
baa9ebc4 344class WXDLLIMPEXP_ADV wxDataViewRendererBase: public wxObject
6842a71a
RR
345{
346public:
b5ec7dd6 347 wxDataViewRendererBase( const wxString &varianttype,
9861f022
RR
348 wxDataViewCellMode mode = wxDATAVIEW_CELL_INERT,
349 int alignment = wxDVR_DEFAULT_ALIGNMENT );
6842a71a 350
9861f022
RR
351 virtual bool Validate( wxVariant& WXUNUSED(value) )
352 { return true; }
f554a14b 353
6842a71a
RR
354 void SetOwner( wxDataViewColumn *owner ) { m_owner = owner; }
355 wxDataViewColumn* GetOwner() { return m_owner; }
f554a14b 356
9861f022
RR
357 // renderer properties:
358
359 virtual bool SetValue( const wxVariant& WXUNUSED(value) ) = 0;
360 virtual bool GetValue( wxVariant& WXUNUSED(value) ) const = 0;
361
362 wxString GetVariantType() const { return m_variantType; }
363
364 virtual void SetMode( wxDataViewCellMode mode ) = 0;
365 virtual wxDataViewCellMode GetMode() const = 0;
366
367 // NOTE: Set/GetAlignment do not take/return a wxAlignment enum but
368 // rather an "int"; that's because for rendering cells it's allowed
369 // to combine alignment flags (e.g. wxALIGN_LEFT|wxALIGN_BOTTOM)
370 virtual void SetAlignment( int align ) = 0;
371 virtual int GetAlignment() const = 0;
b5ec7dd6 372
1e510b1e
RR
373 // in-place editing
374 virtual bool HasEditorCtrl()
375 { return false; }
96c2a0dd
VZ
376 virtual wxControl* CreateEditorCtrl(wxWindow * WXUNUSED(parent),
377 wxRect WXUNUSED(labelRect),
378 const wxVariant& WXUNUSED(value))
1e510b1e 379 { return NULL; }
96c2a0dd
VZ
380 virtual bool GetValueFromEditorCtrl(wxControl * WXUNUSED(editor),
381 wxVariant& WXUNUSED(value))
1e510b1e
RR
382 { return false; }
383
e0062c04 384 virtual bool StartEditing( const wxDataViewItem &item, wxRect labelRect );
1e510b1e
RR
385 virtual void CancelEditing();
386 virtual bool FinishEditing();
b5ec7dd6 387
1e510b1e 388 wxControl *GetEditorCtrl() { return m_editorCtrl; }
b5ec7dd6 389
a7f61f76 390protected:
6842a71a
RR
391 wxString m_variantType;
392 wxDataViewColumn *m_owner;
1e510b1e 393 wxControl *m_editorCtrl;
e0062c04 394 wxDataViewItem m_item; // for m_editorCtrl
6842a71a 395
9861f022
RR
396 // internal utility:
397 const wxDataViewCtrl* GetView() const;
398
6842a71a 399protected:
baa9ebc4 400 DECLARE_DYNAMIC_CLASS_NO_COPY(wxDataViewRendererBase)
6842a71a
RR
401};
402
89352653
RR
403//-----------------------------------------------------------------------------
404// wxDataViewIconText
405//-----------------------------------------------------------------------------
406
d350fbec 407class WXDLLIMPEXP_ADV wxDataViewIconText: public wxObject
89352653
RR
408{
409public:
410 wxDataViewIconText( const wxString &text = wxEmptyString, const wxIcon& icon = wxNullIcon )
5e6f8927
PC
411 : m_text(text), m_icon(icon)
412 { }
89352653
RR
413 wxDataViewIconText( const wxDataViewIconText &other )
414 { m_icon = other.m_icon; m_text = other.m_text; }
415
416 void SetText( const wxString &text ) { m_text = text; }
417 wxString GetText() const { return m_text; }
418 void SetIcon( const wxIcon &icon ) { m_icon = icon; }
419 const wxIcon &GetIcon() const { return m_icon; }
420
421private:
422 wxString m_text;
423 wxIcon m_icon;
424
425private:
426 DECLARE_DYNAMIC_CLASS(wxDataViewIconText)
427};
428
429bool operator == (const wxDataViewIconText &one, const wxDataViewIconText &two);
430
d350fbec 431DECLARE_VARIANT_OBJECT_EXPORTED(wxDataViewIconText, WXDLLIMPEXP_ADV)
89352653 432
f554a14b 433// ---------------------------------------------------------
6842a71a 434// wxDataViewColumnBase
f554a14b 435// ---------------------------------------------------------
6842a71a 436
fa28826d
RR
437enum wxDataViewColumnFlags
438{
e483dfcb
RR
439 wxDATAVIEW_COL_RESIZABLE = 1,
440 wxDATAVIEW_COL_SORTABLE = 2,
441 wxDATAVIEW_COL_REORDERABLE = 4,
442 wxDATAVIEW_COL_HIDDEN = 8
fa28826d
RR
443};
444
f460c29d 445class WXDLLIMPEXP_ADV wxDataViewColumnBase: public wxObject
fa28826d
RR
446{
447public:
b5ec7dd6
VZ
448 wxDataViewColumnBase( const wxString &title, wxDataViewRenderer *renderer,
449 unsigned int model_column, int width = wxDVC_DEFAULT_WIDTH,
87f0efe2
RR
450 wxAlignment align = wxALIGN_CENTER,
451 int flags = wxDATAVIEW_COL_RESIZABLE );
b5ec7dd6
VZ
452 wxDataViewColumnBase( const wxBitmap &bitmap, wxDataViewRenderer *renderer,
453 unsigned int model_column, int width = wxDVC_DEFAULT_WIDTH,
87f0efe2
RR
454 wxAlignment align = wxALIGN_CENTER,
455 int flags = wxDATAVIEW_COL_RESIZABLE );
d3c7fc99 456 virtual ~wxDataViewColumnBase();
fa28826d 457
9861f022 458 // setters:
07b6378f 459
9861f022 460 virtual void SetTitle( const wxString &title ) = 0;
47cef10f 461 virtual void SetAlignment( wxAlignment align ) = 0;
31fb32e1 462 virtual void SetSortable( bool sortable ) = 0;
99c75ebc 463 virtual void SetReorderable(bool reorderable) = 0;
9861f022
RR
464 virtual void SetResizeable( bool resizeable ) = 0;
465 virtual void SetHidden( bool hidden ) = 0;
47cef10f 466 virtual void SetSortOrder( bool ascending ) = 0;
9861f022 467 virtual void SetFlags( int flags );
b5ec7dd6 468 virtual void SetOwner( wxDataViewCtrl *owner )
9861f022
RR
469 { m_owner = owner; }
470 virtual void SetBitmap( const wxBitmap &bitmap )
471 { m_bitmap=bitmap; }
07a84e7b 472
9861f022
RR
473 virtual void SetMinWidth( int minWidth ) = 0;
474 virtual void SetWidth( int width ) = 0;
f554a14b 475
f554a14b 476
9861f022 477 // getters:
07b6378f 478
9861f022
RR
479 virtual wxString GetTitle() const = 0;
480 virtual wxAlignment GetAlignment() const = 0;
87f0efe2 481 virtual int GetWidth() const = 0;
9861f022 482 virtual int GetMinWidth() const = 0;
07b6378f 483
9861f022
RR
484 virtual int GetFlags() const;
485
9861f022 486 virtual bool IsHidden() const = 0;
99c75ebc
RR
487 virtual bool IsReorderable() const = 0;
488 virtual bool IsResizeable() const = 0;
489 virtual bool IsSortable() const = 0;
9861f022
RR
490 virtual bool IsSortOrderAscending() const = 0;
491
492 const wxBitmap &GetBitmap() const { return m_bitmap; }
6d9ecc87 493 unsigned int GetModelColumn() const { return static_cast<unsigned int>(m_model_column); }
9861f022 494
594d5596
RR
495 wxDataViewCtrl *GetOwner() const { return m_owner; }
496 wxDataViewRenderer* GetRenderer() const { return m_renderer; }
9861f022
RR
497
498protected:
baa9ebc4 499 wxDataViewRenderer *m_renderer;
6842a71a 500 int m_model_column;
07a84e7b 501 wxBitmap m_bitmap;
6842a71a 502 wxDataViewCtrl *m_owner;
fa28826d
RR
503
504protected:
505 DECLARE_DYNAMIC_CLASS_NO_COPY(wxDataViewColumnBase)
506};
507
f554a14b 508// ---------------------------------------------------------
239eaa41 509// wxDataViewCtrlBase
f554a14b 510// ---------------------------------------------------------
239eaa41 511
c21f7aa1 512#define wxDV_SINGLE 0x0000 // for convenience
9861f022
RR
513#define wxDV_MULTIPLE 0x0001 // can select multiple items
514
515#define wxDV_NO_HEADER 0x0002 // column titles not visible
516#define wxDV_HORIZ_RULES 0x0004 // light horizontal rules between rows
517#define wxDV_VERT_RULES 0x0008 // light vertical rules between columns
c21f7aa1 518
1a07a730
RR
519#define wxDV_ROW_LINES 0x0010 // alternating colour in rows
520
f460c29d 521class WXDLLIMPEXP_ADV wxDataViewCtrlBase: public wxControl
239eaa41
RR
522{
523public:
524 wxDataViewCtrlBase();
d3c7fc99 525 virtual ~wxDataViewCtrlBase();
f554a14b 526
e0062c04
RR
527 virtual bool AssociateModel( wxDataViewModel *model );
528 wxDataViewModel* GetModel();
a75124d0 529 const wxDataViewModel* GetModel() const;
f554a14b 530
07a84e7b 531 // short cuts
b5ec7dd6 532 wxDataViewColumn *PrependTextColumn( const wxString &label, unsigned int model_column,
736fe67c
RR
533 wxDataViewCellMode mode = wxDATAVIEW_CELL_INERT, int width = -1,
534 wxAlignment align = (wxAlignment)(wxALIGN_LEFT|wxALIGN_CENTRE_VERTICAL),
535 int flags = wxDATAVIEW_COL_RESIZABLE );
b5ec7dd6 536 wxDataViewColumn *PrependIconTextColumn( const wxString &label, unsigned int model_column,
736fe67c
RR
537 wxDataViewCellMode mode = wxDATAVIEW_CELL_INERT, int width = -1,
538 wxAlignment align = (wxAlignment)(wxALIGN_LEFT|wxALIGN_CENTRE_VERTICAL),
539 int flags = wxDATAVIEW_COL_RESIZABLE );
540 wxDataViewColumn *PrependToggleColumn( const wxString &label, unsigned int model_column,
541 wxDataViewCellMode mode = wxDATAVIEW_CELL_INERT, int width = wxDVC_TOGGLE_DEFAULT_WIDTH,
542 wxAlignment align = wxALIGN_CENTER,
543 int flags = wxDATAVIEW_COL_RESIZABLE );
b5ec7dd6 544 wxDataViewColumn *PrependProgressColumn( const wxString &label, unsigned int model_column,
736fe67c
RR
545 wxDataViewCellMode mode = wxDATAVIEW_CELL_INERT, int width = wxDVC_DEFAULT_WIDTH,
546 wxAlignment align = wxALIGN_CENTER,
547 int flags = wxDATAVIEW_COL_RESIZABLE );
548 wxDataViewColumn *PrependDateColumn( const wxString &label, unsigned int model_column,
549 wxDataViewCellMode mode = wxDATAVIEW_CELL_ACTIVATABLE, int width = -1,
550 wxAlignment align = (wxAlignment)(wxALIGN_LEFT|wxALIGN_CENTRE_VERTICAL),
551 int flags = wxDATAVIEW_COL_RESIZABLE );
552 wxDataViewColumn *PrependBitmapColumn( const wxString &label, unsigned int model_column,
553 wxDataViewCellMode mode = wxDATAVIEW_CELL_INERT, int width = -1,
554 wxAlignment align = wxALIGN_CENTER,
555 int flags = wxDATAVIEW_COL_RESIZABLE );
556 wxDataViewColumn *PrependTextColumn( const wxBitmap &label, unsigned int model_column,
557 wxDataViewCellMode mode = wxDATAVIEW_CELL_INERT, int width = -1,
558 wxAlignment align = (wxAlignment)(wxALIGN_LEFT|wxALIGN_CENTRE_VERTICAL),
559 int flags = wxDATAVIEW_COL_RESIZABLE );
560 wxDataViewColumn *PrependIconTextColumn( const wxBitmap &label, unsigned int model_column,
561 wxDataViewCellMode mode = wxDATAVIEW_CELL_INERT, int width = -1,
562 wxAlignment align = (wxAlignment)(wxALIGN_LEFT|wxALIGN_CENTRE_VERTICAL),
563 int flags = wxDATAVIEW_COL_RESIZABLE );
564 wxDataViewColumn *PrependToggleColumn( const wxBitmap &label, unsigned int model_column,
565 wxDataViewCellMode mode = wxDATAVIEW_CELL_INERT, int width = wxDVC_TOGGLE_DEFAULT_WIDTH,
566 wxAlignment align = wxALIGN_CENTER,
567 int flags = wxDATAVIEW_COL_RESIZABLE );
568 wxDataViewColumn *PrependProgressColumn( const wxBitmap &label, unsigned int model_column,
569 wxDataViewCellMode mode = wxDATAVIEW_CELL_INERT, int width = wxDVC_DEFAULT_WIDTH,
570 wxAlignment align = wxALIGN_CENTER,
571 int flags = wxDATAVIEW_COL_RESIZABLE );
572 wxDataViewColumn *PrependDateColumn( const wxBitmap &label, unsigned int model_column,
573 wxDataViewCellMode mode = wxDATAVIEW_CELL_ACTIVATABLE, int width = -1,
574 wxAlignment align = (wxAlignment)(wxALIGN_LEFT|wxALIGN_CENTRE_VERTICAL),
575 int flags = wxDATAVIEW_COL_RESIZABLE );
576 wxDataViewColumn *PrependBitmapColumn( const wxBitmap &label, unsigned int model_column,
577 wxDataViewCellMode mode = wxDATAVIEW_CELL_INERT, int width = -1,
578 wxAlignment align = wxALIGN_CENTER,
579 int flags = wxDATAVIEW_COL_RESIZABLE );
b5ec7dd6
VZ
580
581 wxDataViewColumn *AppendTextColumn( const wxString &label, unsigned int model_column,
87f0efe2 582 wxDataViewCellMode mode = wxDATAVIEW_CELL_INERT, int width = -1,
e2da67f6 583 wxAlignment align = (wxAlignment)(wxALIGN_LEFT|wxALIGN_CENTRE_VERTICAL),
87f0efe2 584 int flags = wxDATAVIEW_COL_RESIZABLE );
b5ec7dd6 585 wxDataViewColumn *AppendIconTextColumn( const wxString &label, unsigned int model_column,
b04fcede 586 wxDataViewCellMode mode = wxDATAVIEW_CELL_INERT, int width = -1,
e2da67f6 587 wxAlignment align = (wxAlignment)(wxALIGN_LEFT|wxALIGN_CENTRE_VERTICAL),
b04fcede 588 int flags = wxDATAVIEW_COL_RESIZABLE );
c7074d44 589 wxDataViewColumn *AppendToggleColumn( const wxString &label, unsigned int model_column,
87f0efe2
RR
590 wxDataViewCellMode mode = wxDATAVIEW_CELL_INERT, int width = wxDVC_TOGGLE_DEFAULT_WIDTH,
591 wxAlignment align = wxALIGN_CENTER,
592 int flags = wxDATAVIEW_COL_RESIZABLE );
b5ec7dd6 593 wxDataViewColumn *AppendProgressColumn( const wxString &label, unsigned int model_column,
87f0efe2
RR
594 wxDataViewCellMode mode = wxDATAVIEW_CELL_INERT, int width = wxDVC_DEFAULT_WIDTH,
595 wxAlignment align = wxALIGN_CENTER,
596 int flags = wxDATAVIEW_COL_RESIZABLE );
c7074d44 597 wxDataViewColumn *AppendDateColumn( const wxString &label, unsigned int model_column,
87f0efe2 598 wxDataViewCellMode mode = wxDATAVIEW_CELL_ACTIVATABLE, int width = -1,
e2da67f6 599 wxAlignment align = (wxAlignment)(wxALIGN_LEFT|wxALIGN_CENTRE_VERTICAL),
87f0efe2 600 int flags = wxDATAVIEW_COL_RESIZABLE );
c7074d44 601 wxDataViewColumn *AppendBitmapColumn( const wxString &label, unsigned int model_column,
87f0efe2
RR
602 wxDataViewCellMode mode = wxDATAVIEW_CELL_INERT, int width = -1,
603 wxAlignment align = wxALIGN_CENTER,
604 int flags = wxDATAVIEW_COL_RESIZABLE );
c7074d44 605 wxDataViewColumn *AppendTextColumn( const wxBitmap &label, unsigned int model_column,
87f0efe2 606 wxDataViewCellMode mode = wxDATAVIEW_CELL_INERT, int width = -1,
e2da67f6 607 wxAlignment align = (wxAlignment)(wxALIGN_LEFT|wxALIGN_CENTRE_VERTICAL),
87f0efe2 608 int flags = wxDATAVIEW_COL_RESIZABLE );
b04fcede
RR
609 wxDataViewColumn *AppendIconTextColumn( const wxBitmap &label, unsigned int model_column,
610 wxDataViewCellMode mode = wxDATAVIEW_CELL_INERT, int width = -1,
e2da67f6 611 wxAlignment align = (wxAlignment)(wxALIGN_LEFT|wxALIGN_CENTRE_VERTICAL),
b04fcede 612 int flags = wxDATAVIEW_COL_RESIZABLE );
c7074d44 613 wxDataViewColumn *AppendToggleColumn( const wxBitmap &label, unsigned int model_column,
87f0efe2
RR
614 wxDataViewCellMode mode = wxDATAVIEW_CELL_INERT, int width = wxDVC_TOGGLE_DEFAULT_WIDTH,
615 wxAlignment align = wxALIGN_CENTER,
616 int flags = wxDATAVIEW_COL_RESIZABLE );
c7074d44 617 wxDataViewColumn *AppendProgressColumn( const wxBitmap &label, unsigned int model_column,
87f0efe2
RR
618 wxDataViewCellMode mode = wxDATAVIEW_CELL_INERT, int width = wxDVC_DEFAULT_WIDTH,
619 wxAlignment align = wxALIGN_CENTER,
620 int flags = wxDATAVIEW_COL_RESIZABLE );
c7074d44 621 wxDataViewColumn *AppendDateColumn( const wxBitmap &label, unsigned int model_column,
87f0efe2 622 wxDataViewCellMode mode = wxDATAVIEW_CELL_ACTIVATABLE, int width = -1,
e2da67f6 623 wxAlignment align = (wxAlignment)(wxALIGN_LEFT|wxALIGN_CENTRE_VERTICAL),
87f0efe2 624 int flags = wxDATAVIEW_COL_RESIZABLE );
c7074d44 625 wxDataViewColumn *AppendBitmapColumn( const wxBitmap &label, unsigned int model_column,
87f0efe2
RR
626 wxDataViewCellMode mode = wxDATAVIEW_CELL_INERT, int width = -1,
627 wxAlignment align = wxALIGN_CENTER,
628 int flags = wxDATAVIEW_COL_RESIZABLE );
736fe67c
RR
629
630
631 virtual bool PrependColumn( wxDataViewColumn *col );
f554a14b 632 virtual bool AppendColumn( wxDataViewColumn *col );
9861f022 633
91a6c655
RR
634 virtual unsigned int GetColumnCount() const = 0;
635 virtual wxDataViewColumn* GetColumn( unsigned int pos ) const = 0;
453091c2 636 virtual int GetColumnPosition( const wxDataViewColumn *column ) const = 0;
b5ec7dd6 637
91a6c655
RR
638 virtual bool DeleteColumn( wxDataViewColumn *column ) = 0;
639 virtual bool ClearColumns() = 0;
b5ec7dd6 640
1b27b2bd 641 void SetExpanderColumn( wxDataViewColumn *col )
3b6280be 642 { m_expander_column = col ; DoSetExpanderColumn(); }
b5ec7dd6 643 wxDataViewColumn *GetExpanderColumn() const
3b6280be 644 { return m_expander_column; }
b5ec7dd6 645
21f47fb9 646 virtual wxDataViewColumn *GetSortingColumn() const = 0;
3b6280be
RR
647
648 void SetIndent( int indent )
649 { m_indent = indent ; DoSetIndent(); }
b5ec7dd6
VZ
650 int GetIndent() const
651 { return m_indent; }
3b6280be 652
fbda518c 653 virtual wxDataViewItem GetSelection() const = 0;
b7e9f8b1
RR
654 virtual int GetSelections( wxDataViewItemArray & sel ) const = 0;
655 virtual void SetSelections( const wxDataViewItemArray & sel ) = 0;
656 virtual void Select( const wxDataViewItem & item ) = 0;
657 virtual void Unselect( const wxDataViewItem & item ) = 0;
658 virtual bool IsSelected( const wxDataViewItem & item ) const = 0;
659
b7e9f8b1
RR
660 virtual void SelectAll() = 0;
661 virtual void UnselectAll() = 0;
662
f71d3ba4
RR
663 virtual void Expand( const wxDataViewItem & item ) = 0;
664 virtual void Collapse( const wxDataViewItem & item ) = 0;
665
6154212e 666 virtual void EnsureVisible( const wxDataViewItem & item,
fbda518c 667 const wxDataViewColumn *column = NULL ) = 0;
a87b466d 668 virtual void HitTest( const wxPoint & point, wxDataViewItem &item, wxDataViewColumn* &column ) const = 0;
fbda518c 669 virtual wxRect GetItemRect( const wxDataViewItem & item, const wxDataViewColumn *column = NULL ) const = 0;
b7e9f8b1 670
3b6280be
RR
671protected:
672 virtual void DoSetExpanderColumn() = 0 ;
673 virtual void DoSetIndent() = 0;
674
239eaa41 675private:
e0062c04 676 wxDataViewModel *m_model;
1b27b2bd 677 wxDataViewColumn *m_expander_column;
3b6280be 678 int m_indent ;
b5ec7dd6 679
239eaa41 680protected:
260b9be7 681 DECLARE_DYNAMIC_CLASS_NO_COPY(wxDataViewCtrlBase)
239eaa41 682};
bcd846ea 683
eb7f97f8
RR
684// ----------------------------------------------------------------------------
685// wxDataViewEvent - the event class for the wxDataViewCtrl notifications
686// ----------------------------------------------------------------------------
687
2f799ae8 688class WXDLLIMPEXP_ADV wxDataViewEvent : public wxNotifyEvent
eb7f97f8
RR
689{
690public:
691 wxDataViewEvent(wxEventType commandType = wxEVT_NULL, int winid = 0)
692 : wxNotifyEvent(commandType, winid),
e0062c04 693 m_item(0),
eb7f97f8 694 m_col(-1),
eb7f97f8
RR
695 m_model(NULL),
696 m_value(wxNullVariant),
6af3eec2
RR
697 m_column(NULL),
698 m_pos(-1,-1)
eb7f97f8
RR
699 { }
700
701 wxDataViewEvent(const wxDataViewEvent& event)
702 : wxNotifyEvent(event),
e0062c04 703 m_item(event.m_item),
eb7f97f8 704 m_col(event.m_col),
eb7f97f8
RR
705 m_model(event.m_model),
706 m_value(event.m_value),
6af3eec2
RR
707 m_column(event.m_column),
708 m_pos(m_pos)
eb7f97f8
RR
709 { }
710
e0062c04
RR
711 wxDataViewItem GetItem() const { return m_item; }
712 void SetItem( const wxDataViewItem &item ) { m_item = item; }
713
eb7f97f8
RR
714 int GetColumn() const { return m_col; }
715 void SetColumn( int col ) { m_col = col; }
9861f022 716
eb7f97f8
RR
717 wxDataViewModel* GetModel() const { return m_model; }
718 void SetModel( wxDataViewModel *model ) { m_model = model; }
9861f022 719
eb7f97f8
RR
720 const wxVariant &GetValue() const { return m_value; }
721 void SetValue( const wxVariant &value ) { m_value = value; }
722
31fb32e1
RR
723 // for wxEVT_DATAVIEW_COLUMN_HEADER_CLICKED only
724 void SetDataViewColumn( wxDataViewColumn *col ) { m_column = col; }
9861f022 725 wxDataViewColumn *GetDataViewColumn() const { return m_column; }
6af3eec2
RR
726
727 // for wxEVT_DATAVIEW_CONTEXT_MENU only
728 wxPoint GetPosition() const;
729 void SetPosition( int x, int y ) { m_pos.x = x; m_pos.y = y; }
31fb32e1 730
eb7f97f8
RR
731 virtual wxEvent *Clone() const { return new wxDataViewEvent(*this); }
732
733protected:
e0062c04 734 wxDataViewItem m_item;
eb7f97f8 735 int m_col;
eb7f97f8
RR
736 wxDataViewModel *m_model;
737 wxVariant m_value;
31fb32e1 738 wxDataViewColumn *m_column;
6af3eec2 739 wxPoint m_pos;
eb7f97f8
RR
740
741private:
742 DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxDataViewEvent)
743};
744
745BEGIN_DECLARE_EVENT_TYPES()
d86c1870 746 DECLARE_EXPORTED_EVENT_TYPE(WXDLLIMPEXP_ADV, wxEVT_COMMAND_DATAVIEW_SELECTION_CHANGED, -1)
b5ec7dd6 747
e0062c04 748 DECLARE_EXPORTED_EVENT_TYPE(WXDLLIMPEXP_ADV, wxEVT_COMMAND_DATAVIEW_ITEM_ACTIVATED, -1)
d209a914
RR
749 DECLARE_EXPORTED_EVENT_TYPE(WXDLLIMPEXP_ADV, wxEVT_COMMAND_DATAVIEW_ITEM_COLLAPSED, -1)
750 DECLARE_EXPORTED_EVENT_TYPE(WXDLLIMPEXP_ADV, wxEVT_COMMAND_DATAVIEW_ITEM_EXPANDED, -1)
6977c3bf
RR
751 DECLARE_EXPORTED_EVENT_TYPE(WXDLLIMPEXP_ADV, wxEVT_COMMAND_DATAVIEW_ITEM_COLLAPSING, -1)
752 DECLARE_EXPORTED_EVENT_TYPE(WXDLLIMPEXP_ADV, wxEVT_COMMAND_DATAVIEW_ITEM_EXPANDING, -1)
e0000f94
RR
753 DECLARE_EXPORTED_EVENT_TYPE(WXDLLIMPEXP_ADV, wxEVT_COMMAND_DATAVIEW_ITEM_EDITING_STARTED, -1)
754 DECLARE_EXPORTED_EVENT_TYPE(WXDLLIMPEXP_ADV, wxEVT_COMMAND_DATAVIEW_ITEM_EDITING_DONE, -1)
6608fdab 755 DECLARE_EXPORTED_EVENT_TYPE(WXDLLIMPEXP_ADV, wxEVT_COMMAND_DATAVIEW_ITEM_VALUE_CHANGED, -1)
6af3eec2
RR
756
757 DECLARE_EXPORTED_EVENT_TYPE(WXDLLIMPEXP_ADV, wxEVT_COMMAND_DATAVIEW_ITEM_CONTEXT_MENU, -1)
b5ec7dd6 758
e07c1146
PC
759 DECLARE_EXPORTED_EVENT_TYPE(WXDLLIMPEXP_ADV, wxEVT_COMMAND_DATAVIEW_COLUMN_HEADER_CLICK, -1)
760 DECLARE_EXPORTED_EVENT_TYPE(WXDLLIMPEXP_ADV, wxEVT_COMMAND_DATAVIEW_COLUMN_HEADER_RIGHT_CLICK, -1)
c0a66d92 761 DECLARE_EXPORTED_EVENT_TYPE(WXDLLIMPEXP_ADV, wxEVT_COMMAND_DATAVIEW_COLUMN_SORTED, -1)
e483dfcb 762 DECLARE_EXPORTED_EVENT_TYPE(WXDLLIMPEXP_ADV, wxEVT_COMMAND_DATAVIEW_COLUMN_REORDERED, -1)
eb7f97f8
RR
763END_DECLARE_EVENT_TYPES()
764
765typedef void (wxEvtHandler::*wxDataViewEventFunction)(wxDataViewEvent&);
766
767#define wxDataViewEventHandler(func) \
768 (wxObjectEventFunction)(wxEventFunction)wxStaticCastEvent(wxDataViewEventFunction, &func)
769
770#define wx__DECLARE_DATAVIEWEVT(evt, id, fn) \
771 wx__DECLARE_EVT1(wxEVT_COMMAND_DATAVIEW_ ## evt, id, wxDataViewEventHandler(fn))
772
d86c1870
RR
773#define EVT_DATAVIEW_SELECTION_CHANGED(id, fn) wx__DECLARE_DATAVIEWEVT(SELECTION_CHANGED, id, fn)
774
e0062c04 775#define EVT_DATAVIEW_ITEM_ACTIVATED(id, fn) wx__DECLARE_DATAVIEWEVT(ITEM_ACTIVATED, id, fn)
6977c3bf 776#define EVT_DATAVIEW_ITEM_COLLAPSING(id, fn) wx__DECLARE_DATAVIEWEVT(ITEM_COLLAPSING, id, fn)
3ecb8a53 777#define EVT_DATAVIEW_ITEM_COLLAPSED(id, fn) wx__DECLARE_DATAVIEWEVT(ITEM_COLLAPSED, id, fn)
6977c3bf 778#define EVT_DATAVIEW_ITEM_EXPANDING(id, fn) wx__DECLARE_DATAVIEWEVT(ITEM_EXPANDING, id, fn)
3ecb8a53 779#define EVT_DATAVIEW_ITEM_EXPANDED(id, fn) wx__DECLARE_DATAVIEWEVT(ITEM_EXPANDED, id, fn)
e0000f94
RR
780#define EVT_DATAVIEW_ITEM_EDITING_STARTED(id, fn) wx__DECLARE_DATAVIEWEVT(ITEM_EDITING_STARTED, id, fn)
781#define EVT_DATAVIEW_ITEM_EDITING_DONE(id, fn) wx__DECLARE_DATAVIEWEVT(ITEM_EDITING_DONE, id, fn)
6608fdab 782#define EVT_DATAVIEW_ITEM_VALUE_CHANGED(id, fn) wx__DECLARE_DATAVIEWEVT(ITEM_VALUE_CHANGED, id, fn)
e0000f94 783
6af3eec2
RR
784#define EVT_DATAVIEW_ITEM_CONTEXT_MENU(id, fn) wx__DECLARE_DATAVIEWEVT(ITEM_CONTEXT_MENU, id, fn)
785
31fb32e1
RR
786#define EVT_DATAVIEW_COLUMN_HEADER_CLICK(id, fn) wx__DECLARE_DATAVIEWEVT(COLUMN_HEADER_CLICK, id, fn)
787#define EVT_DATAVIEW_COLUMN_HEADER_RIGHT_CLICKED(id, fn) wx__DECLARE_DATAVIEWEVT(COLUMN_HEADER_RIGHT_CLICK, id, fn)
c0a66d92 788#define EVT_DATAVIEW_COLUMN_SORTED(id, fn) wx__DECLARE_DATAVIEWEVT(COLUMN_SORTED, id, fn)
e483dfcb 789#define EVT_DATAVIEW_COLUMN_REORDERED(id, fn) wx__DECLARE_DATAVIEWEVT(COLUMN_REORDERED, id, fn)
eb7f97f8 790
4ed7af08
RR
791#if defined(wxUSE_GENERICDATAVIEWCTRL)
792 #include "wx/generic/dataview.h"
793#elif defined(__WXGTK20__)
bcd846ea
RR
794 #include "wx/gtk/dataview.h"
795#elif defined(__WXMAC__)
c0a66d92 796 #include "wx/mac/dataview.h"
bcd846ea
RR
797#else
798 #include "wx/generic/dataview.h"
799#endif
800
52e750fc
RR
801// -------------------------------------
802// wxDataViewSpinRenderer
803// -------------------------------------
804
4660b556 805class WXDLLIMPEXP_ADV wxDataViewSpinRenderer: public wxDataViewCustomRenderer
52e750fc
RR
806{
807public:
808 wxDataViewSpinRenderer( int min, int max,
809 wxDataViewCellMode mode = wxDATAVIEW_CELL_EDITABLE,
810 int alignment = wxDVR_DEFAULT_ALIGNMENT );
811 virtual bool HasEditorCtrl() { return true; }
812 virtual wxControl* CreateEditorCtrl( wxWindow *parent, wxRect labelRect, const wxVariant &value );
813 virtual bool GetValueFromEditorCtrl( wxControl* editor, wxVariant &value );
814 virtual bool Render( wxRect rect, wxDC *dc, int state );
815 virtual wxSize GetSize() const;
816 virtual bool SetValue( const wxVariant &value );
817 virtual bool GetValue( wxVariant &value ) const;
b5ec7dd6 818
52e750fc
RR
819private:
820 long m_data;
821 long m_min,m_max;
822};
823
e94d0c1e
RR
824//-----------------------------------------------------------------------------
825// wxDataViewTreeStore
826//-----------------------------------------------------------------------------
827
828class WXDLLIMPEXP_ADV wxDataViewTreeStoreNode
829{
830public:
831 wxDataViewTreeStoreNode( wxDataViewTreeStoreNode *parent,
832 const wxString &text, const wxIcon &icon = wxNullIcon, wxClientData *data = NULL );
833 virtual ~wxDataViewTreeStoreNode();
b5ec7dd6
VZ
834
835 void SetText( const wxString &text )
e94d0c1e
RR
836 { m_text = text; }
837 wxString GetText() const
838 { return m_text; }
839 void SetIcon( const wxIcon &icon )
840 { m_icon = icon; }
841 const wxIcon &GetIcon() const
842 { return m_icon; }
843 void SetData( wxClientData *data )
844 { if (m_data) delete m_data; m_data = data; }
845 wxClientData *GetData() const
846 { return m_data; }
b5ec7dd6 847
e94d0c1e
RR
848 wxDataViewItem GetItem() const
849 { return wxDataViewItem( (void*) this ); }
b5ec7dd6 850
e94d0c1e
RR
851 virtual bool IsContainer()
852 { return false; }
b5ec7dd6 853
e94d0c1e
RR
854 wxDataViewTreeStoreNode *GetParent()
855 { return m_parent; }
b5ec7dd6 856
e94d0c1e
RR
857private:
858 wxDataViewTreeStoreNode *m_parent;
859 wxString m_text;
860 wxIcon m_icon;
861 wxClientData *m_data;
862};
863
864WX_DECLARE_LIST_WITH_DECL(wxDataViewTreeStoreNode, wxDataViewTreeStoreNodeList,
865 class WXDLLIMPEXP_ADV);
866
867class WXDLLIMPEXP_ADV wxDataViewTreeStoreContainerNode: public wxDataViewTreeStoreNode
868{
869public:
b5ec7dd6
VZ
870 wxDataViewTreeStoreContainerNode( wxDataViewTreeStoreNode *parent,
871 const wxString &text, const wxIcon &icon = wxNullIcon, const wxIcon &expanded = wxNullIcon,
e94d0c1e
RR
872 wxClientData *data = NULL );
873 virtual ~wxDataViewTreeStoreContainerNode();
874
b5ec7dd6 875 const wxDataViewTreeStoreNodeList &GetChildren() const
e94d0c1e 876 { return m_children; }
b5ec7dd6 877 wxDataViewTreeStoreNodeList &GetChildren()
e94d0c1e
RR
878 { return m_children; }
879
880 void SetExpandedIcon( const wxIcon &icon )
881 { m_iconExpanded = icon; }
882 const wxIcon &GetExpandedIcon() const
883 { return m_iconExpanded; }
b5ec7dd6 884
a75124d0
RR
885 void SetExpanded( bool expanded = true )
886 { m_isExpanded = expanded; }
887 bool IsExpanded() const
888 { return m_isExpanded; }
889
e94d0c1e
RR
890 virtual bool IsContainer()
891 { return true; }
b5ec7dd6 892
e94d0c1e
RR
893private:
894 wxDataViewTreeStoreNodeList m_children;
895 wxIcon m_iconExpanded;
a75124d0 896 bool m_isExpanded;
e94d0c1e
RR
897};
898
899//-----------------------------------------------------------------------------
900
901class WXDLLIMPEXP_ADV wxDataViewTreeStore: public wxDataViewModel
902{
903public:
904 wxDataViewTreeStore();
905 ~wxDataViewTreeStore();
906
b5ec7dd6 907 wxDataViewItem AppendItem( const wxDataViewItem& parent,
e94d0c1e
RR
908 const wxString &text, const wxIcon &icon = wxNullIcon, wxClientData *data = NULL );
909 wxDataViewItem PrependItem( const wxDataViewItem& parent,
910 const wxString &text, const wxIcon &icon = wxNullIcon, wxClientData *data = NULL );
911 wxDataViewItem InsertItem( const wxDataViewItem& parent, const wxDataViewItem& previous,
912 const wxString &text, const wxIcon &icon = wxNullIcon, wxClientData *data = NULL );
b5ec7dd6
VZ
913
914 wxDataViewItem PrependContainer( const wxDataViewItem& parent,
915 const wxString &text, const wxIcon &icon = wxNullIcon, const wxIcon &expanded = wxNullIcon,
e94d0c1e
RR
916 wxClientData *data = NULL );
917 wxDataViewItem AppendContainer( const wxDataViewItem& parent,
b5ec7dd6 918 const wxString &text, const wxIcon &icon = wxNullIcon, const wxIcon &expanded = wxNullIcon,
e94d0c1e
RR
919 wxClientData *data = NULL );
920 wxDataViewItem InsertContainer( const wxDataViewItem& parent, const wxDataViewItem& previous,
b5ec7dd6 921 const wxString &text, const wxIcon &icon = wxNullIcon, const wxIcon &expanded = wxNullIcon,
e94d0c1e
RR
922 wxClientData *data = NULL );
923
924 wxDataViewItem GetNthChild( const wxDataViewItem& parent, unsigned int pos ) const;
925 int GetChildCount( const wxDataViewItem& parent ) const;
b5ec7dd6 926
e94d0c1e
RR
927 void SetItemText( const wxDataViewItem& item, const wxString &text );
928 wxString GetItemText( const wxDataViewItem& item ) const;
b5ec7dd6 929 void SetItemIcon( const wxDataViewItem& item, const wxIcon &icon );
e94d0c1e
RR
930 const wxIcon &GetItemIcon( const wxDataViewItem& item ) const;
931 void SetItemExpandedIcon( const wxDataViewItem& item, const wxIcon &icon );
932 const wxIcon &GetItemExpandedIcon( const wxDataViewItem& item ) const;
933 void SetItemData( const wxDataViewItem& item, wxClientData *data );
934 wxClientData *GetItemData( const wxDataViewItem& item ) const;
935
936 void DeleteItem( const wxDataViewItem& item );
937 void DeleteChildren( const wxDataViewItem& item );
938 void DeleteAllItems();
b5ec7dd6 939
e94d0c1e
RR
940 // implement base methods
941
b5ec7dd6 942 virtual void GetValue( wxVariant &variant,
e94d0c1e 943 const wxDataViewItem &item, unsigned int col ) const;
b5ec7dd6 944 virtual bool SetValue( const wxVariant &variant,
e94d0c1e
RR
945 const wxDataViewItem &item, unsigned int col );
946 virtual wxDataViewItem GetParent( const wxDataViewItem &item ) const;
947 virtual bool IsContainer( const wxDataViewItem &item ) const;
948 virtual unsigned int GetChildren( const wxDataViewItem &item, wxDataViewItemArray &children ) const;
949
b5ec7dd6 950 virtual int Compare( const wxDataViewItem &item1, const wxDataViewItem &item2,
e94d0c1e 951 unsigned int column, bool ascending );
b5ec7dd6
VZ
952
953 virtual bool HasDefaultCompare() const
e94d0c1e 954 { return true; }
b5ec7dd6 955 virtual unsigned int GetColumnCount() const
e94d0c1e 956 { return 1; };
b5ec7dd6 957 virtual wxString GetColumnType( unsigned int WXUNUSED(col) ) const
594d5596 958 { return wxT("wxDataViewIconText"); }
b5ec7dd6 959
e94d0c1e
RR
960 wxDataViewTreeStoreNode *FindNode( const wxDataViewItem &item ) const;
961 wxDataViewTreeStoreContainerNode *FindContainerNode( const wxDataViewItem &item ) const;
962 wxDataViewTreeStoreNode *GetRoot() const { return m_root; }
b5ec7dd6 963
e94d0c1e
RR
964public:
965 wxDataViewTreeStoreNode *m_root;
966};
967
e94d0c1e
RR
968class WXDLLIMPEXP_ADV wxDataViewTreeCtrl: public wxDataViewCtrl
969{
970public:
a75124d0
RR
971 wxDataViewTreeCtrl();
972 wxDataViewTreeCtrl( wxWindow *parent, wxWindowID id,
e94d0c1e 973 const wxPoint& pos = wxDefaultPosition,
1a07a730 974 const wxSize& size = wxDefaultSize, long style = wxDV_NO_HEADER | wxDV_ROW_LINES,
e94d0c1e 975 const wxValidator& validator = wxDefaultValidator );
a75124d0 976 ~wxDataViewTreeCtrl();
e94d0c1e
RR
977
978 bool Create( wxWindow *parent, wxWindowID id,
979 const wxPoint& pos = wxDefaultPosition,
1a07a730 980 const wxSize& size = wxDefaultSize, long style = wxDV_NO_HEADER | wxDV_ROW_LINES,
e94d0c1e
RR
981 const wxValidator& validator = wxDefaultValidator );
982
983 wxDataViewTreeStore *GetStore()
984 { return (wxDataViewTreeStore*) GetModel(); }
a75124d0
RR
985 const wxDataViewTreeStore *GetStore() const
986 { return (const wxDataViewTreeStore*) GetModel(); }
b5ec7dd6 987
a75124d0
RR
988 void SetImageList( wxImageList *imagelist );
989 wxImageList* GetImageList() { return m_imageList; }
990
991 wxDataViewItem AppendItem( const wxDataViewItem& parent,
992 const wxString &text, int icon = -1, wxClientData *data = NULL );
993 wxDataViewItem PrependItem( const wxDataViewItem& parent,
994 const wxString &text, int icon = -1, wxClientData *data = NULL );
995 wxDataViewItem InsertItem( const wxDataViewItem& parent, const wxDataViewItem& previous,
996 const wxString &text, int icon = -1, wxClientData *data = NULL );
997
998 wxDataViewItem PrependContainer( const wxDataViewItem& parent,
999 const wxString &text, int icon = -1, int expanded = -1,
1000 wxClientData *data = NULL );
1001 wxDataViewItem AppendContainer( const wxDataViewItem& parent,
1002 const wxString &text, int icon = -1, int expanded = -1,
1003 wxClientData *data = NULL );
1004 wxDataViewItem InsertContainer( const wxDataViewItem& parent, const wxDataViewItem& previous,
1005 const wxString &text, int icon = -1, int expanded = -1,
1006 wxClientData *data = NULL );
1007
1008 wxDataViewItem GetNthChild( const wxDataViewItem& parent, unsigned int pos ) const
1009 { return GetStore()->GetNthChild(parent, pos); }
1010 int GetChildCount( const wxDataViewItem& parent ) const
1011 { return GetStore()->GetChildCount(parent); }
1012
1013 void SetItemText( const wxDataViewItem& item, const wxString &text )
1014 { GetStore()->SetItemText(item,text); }
1015 wxString GetItemText( const wxDataViewItem& item ) const
1016 { return GetStore()->GetItemText(item); }
1017 void SetItemIcon( const wxDataViewItem& item, const wxIcon &icon )
1018 { GetStore()->SetItemIcon(item,icon); }
1019 const wxIcon &GetItemIcon( const wxDataViewItem& item ) const
1020 { return GetStore()->GetItemIcon(item); }
1021 void SetItemExpandedIcon( const wxDataViewItem& item, const wxIcon &icon )
1022 { GetStore()->SetItemExpandedIcon(item,icon); }
1023 const wxIcon &GetItemExpandedIcon( const wxDataViewItem& item ) const
1024 { return GetStore()->GetItemExpandedIcon(item); }
1025 void SetItemData( const wxDataViewItem& item, wxClientData *data )
1026 { GetStore()->SetItemData(item,data); }
1027 wxClientData *GetItemData( const wxDataViewItem& item ) const
1028 { return GetStore()->GetItemData(item); }
1029
1030 void DeleteItem( const wxDataViewItem& item )
1031 { GetStore()->DeleteItem(item); }
1032 void DeleteChildren( const wxDataViewItem& item )
1033 { GetStore()->DeleteChildren(item); }
1034 void DeleteAllItems()
1035 { GetStore()->DeleteAllItems(); }
1036
1037 void OnExpanded( wxDataViewEvent &event );
1038 void OnCollapsed( wxDataViewEvent &event );
1a07a730 1039 void OnSize( wxSizeEvent &event );
b5ec7dd6 1040
e94d0c1e 1041private:
a75124d0
RR
1042 wxImageList *m_imageList;
1043
1044private:
1045 DECLARE_EVENT_TABLE()
e94d0c1e
RR
1046 DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxDataViewTreeCtrl)
1047};
e94d0c1e 1048
bcd846ea
RR
1049#endif // wxUSE_DATAVIEWCTRL
1050
1051#endif
1052 // _WX_DATAVIEW_H_BASE_