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