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