]> git.saurik.com Git - wxWidgets.git/blame - include/wx/dataview.h
projects / wxWidgets.git / blame
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (incremental) | history | HEAD
Separate label with wx mnemonics (&) and with gtk mnemonics (_) into m_text and m_gtk...
[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 );
19723525 701 virtual bool InsertColumn( unsigned int pos, wxDataViewColumn *col );
f554a14b 702 virtual bool AppendColumn( wxDataViewColumn *col );
9861f022 703
91a6c655
RR		 704 virtual unsigned int GetColumnCount() const = 0;
705 virtual wxDataViewColumn* GetColumn( unsigned int pos ) const = 0;
453091c2 706 virtual int GetColumnPosition( const wxDataViewColumn *column ) const = 0;
b5ec7dd6 707
91a6c655
RR		 708 virtual bool DeleteColumn( wxDataViewColumn *column ) = 0;
709 virtual bool ClearColumns() = 0;
b5ec7dd6 710
1b27b2bd 711 void SetExpanderColumn( wxDataViewColumn *col )
3b6280be 712 { m_expander_column = col ; DoSetExpanderColumn(); }
b5ec7dd6 713 wxDataViewColumn *GetExpanderColumn() const
3b6280be 714 { return m_expander_column; }
b5ec7dd6 715
21f47fb9 716 virtual wxDataViewColumn *GetSortingColumn() const = 0;
344ed1f3 717
3b6280be
RR		 718 void SetIndent( int indent )
719 { m_indent = indent ; DoSetIndent(); }
b5ec7dd6
VZ		 720 int GetIndent() const
721 { return m_indent; }
3b6280be 722
fbda518c 723 virtual wxDataViewItem GetSelection() const = 0;
b7e9f8b1
RR		 724 virtual int GetSelections( wxDataViewItemArray & sel ) const = 0;
725 virtual void SetSelections( const wxDataViewItemArray & sel ) = 0;
726 virtual void Select( const wxDataViewItem & item ) = 0;
727 virtual void Unselect( const wxDataViewItem & item ) = 0;
728 virtual bool IsSelected( const wxDataViewItem & item ) const = 0;
729
b7e9f8b1
RR		 730 virtual void SelectAll() = 0;
731 virtual void UnselectAll() = 0;
732
f71d3ba4
RR		 733 virtual void Expand( const wxDataViewItem & item ) = 0;
734 virtual void Collapse( const wxDataViewItem & item ) = 0;
735
6154212e 736 virtual void EnsureVisible( const wxDataViewItem & item,
fbda518c 737 const wxDataViewColumn *column = NULL ) = 0;
a87b466d 738 virtual void HitTest( const wxPoint & point, wxDataViewItem &item, wxDataViewColumn* &column ) const = 0;
fbda518c 739 virtual wxRect GetItemRect( const wxDataViewItem & item, const wxDataViewColumn *column = NULL ) const = 0;
b7e9f8b1 740
3b6280be
RR		 741protected:
742 virtual void DoSetExpanderColumn() = 0 ;
743 virtual void DoSetIndent() = 0;
744
239eaa41 745private:
e0062c04 746 wxDataViewModel *m_model;
1b27b2bd 747 wxDataViewColumn *m_expander_column;
3b6280be 748 int m_indent ;
b5ec7dd6 749
239eaa41 750protected:
260b9be7 751 DECLARE_DYNAMIC_CLASS_NO_COPY(wxDataViewCtrlBase)
239eaa41 752};
bcd846ea 753
eb7f97f8
RR		 754// ----------------------------------------------------------------------------
755// wxDataViewEvent - the event class for the wxDataViewCtrl notifications
756// ----------------------------------------------------------------------------
757
2f799ae8 758class WXDLLIMPEXP_ADV wxDataViewEvent : public wxNotifyEvent
eb7f97f8
RR		 759{
760public:
761 wxDataViewEvent(wxEventType commandType = wxEVT_NULL, int winid = 0)
762 : wxNotifyEvent(commandType, winid),
e0062c04 763 m_item(0),
eb7f97f8 764 m_col(-1),
eb7f97f8
RR		 765 m_model(NULL),
766 m_value(wxNullVariant),
6af3eec2
RR		 767 m_column(NULL),
768 m_pos(-1,-1)
eb7f97f8
RR		 769 { }
770
771 wxDataViewEvent(const wxDataViewEvent& event)
772 : wxNotifyEvent(event),
e0062c04 773 m_item(event.m_item),
eb7f97f8 774 m_col(event.m_col),
eb7f97f8
RR		 775 m_model(event.m_model),
776 m_value(event.m_value),
6af3eec2
RR		 777 m_column(event.m_column),
778 m_pos(m_pos)
eb7f97f8
RR		 779 { }
780
e0062c04
RR		 781 wxDataViewItem GetItem() const { return m_item; }
782 void SetItem( const wxDataViewItem &item ) { m_item = item; }
783
eb7f97f8
RR		 784 int GetColumn() const { return m_col; }
785 void SetColumn( int col ) { m_col = col; }
9861f022 786
eb7f97f8
RR		 787 wxDataViewModel* GetModel() const { return m_model; }
788 void SetModel( wxDataViewModel *model ) { m_model = model; }
9861f022 789
eb7f97f8
RR		 790 const wxVariant &GetValue() const { return m_value; }
791 void SetValue( const wxVariant &value ) { m_value = value; }
792
31fb32e1
RR		 793 // for wxEVT_DATAVIEW_COLUMN_HEADER_CLICKED only
794 void SetDataViewColumn( wxDataViewColumn *col ) { m_column = col; }
9861f022 795 wxDataViewColumn *GetDataViewColumn() const { return m_column; }
c058cafa 796
6af3eec2 797 // for wxEVT_DATAVIEW_CONTEXT_MENU only
5cfb6fee 798 wxPoint GetPosition() const { return m_pos; }
6af3eec2 799 void SetPosition( int x, int y ) { m_pos.x = x; m_pos.y = y; }
31fb32e1 800
eb7f97f8
RR		 801 virtual wxEvent *Clone() const { return new wxDataViewEvent(*this); }
802
803protected:
e0062c04 804 wxDataViewItem m_item;
eb7f97f8 805 int m_col;
eb7f97f8
RR		 806 wxDataViewModel *m_model;
807 wxVariant m_value;
31fb32e1 808 wxDataViewColumn *m_column;
6af3eec2 809 wxPoint m_pos;
eb7f97f8
RR		 810
811private:
812 DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxDataViewEvent)
813};
814
c058cafa
VZ		 815extern WXDLLIMPEXP_ADV const wxEventType wxEVT_COMMAND_DATAVIEW_SELECTION_CHANGED;
816
817extern WXDLLIMPEXP_ADV const wxEventType wxEVT_COMMAND_DATAVIEW_ITEM_ACTIVATED;
818extern WXDLLIMPEXP_ADV const wxEventType wxEVT_COMMAND_DATAVIEW_ITEM_COLLAPSED;
819extern WXDLLIMPEXP_ADV const wxEventType wxEVT_COMMAND_DATAVIEW_ITEM_EXPANDED;
820extern WXDLLIMPEXP_ADV const wxEventType wxEVT_COMMAND_DATAVIEW_ITEM_COLLAPSING;
821extern WXDLLIMPEXP_ADV const wxEventType wxEVT_COMMAND_DATAVIEW_ITEM_EXPANDING;
822extern WXDLLIMPEXP_ADV const wxEventType wxEVT_COMMAND_DATAVIEW_ITEM_EDITING_STARTED;
823extern WXDLLIMPEXP_ADV const wxEventType wxEVT_COMMAND_DATAVIEW_ITEM_EDITING_DONE;
824extern WXDLLIMPEXP_ADV const wxEventType wxEVT_COMMAND_DATAVIEW_ITEM_VALUE_CHANGED;
825
826extern WXDLLIMPEXP_ADV const wxEventType wxEVT_COMMAND_DATAVIEW_ITEM_CONTEXT_MENU;
827
828extern WXDLLIMPEXP_ADV const wxEventType wxEVT_COMMAND_DATAVIEW_COLUMN_HEADER_CLICK;
829extern WXDLLIMPEXP_ADV const wxEventType wxEVT_COMMAND_DATAVIEW_COLUMN_HEADER_RIGHT_CLICK;
830extern WXDLLIMPEXP_ADV const wxEventType wxEVT_COMMAND_DATAVIEW_COLUMN_SORTED;
831extern WXDLLIMPEXP_ADV const wxEventType wxEVT_COMMAND_DATAVIEW_COLUMN_REORDERED;
eb7f97f8
RR		 832
833typedef void (wxEvtHandler::*wxDataViewEventFunction)(wxDataViewEvent&);
834
835#define wxDataViewEventHandler(func) \
836 (wxObjectEventFunction)(wxEventFunction)wxStaticCastEvent(wxDataViewEventFunction, &func)
837
838#define wx__DECLARE_DATAVIEWEVT(evt, id, fn) \
839 wx__DECLARE_EVT1(wxEVT_COMMAND_DATAVIEW_ ## evt, id, wxDataViewEventHandler(fn))
840
d86c1870
RR		 841#define EVT_DATAVIEW_SELECTION_CHANGED(id, fn) wx__DECLARE_DATAVIEWEVT(SELECTION_CHANGED, id, fn)
842
e0062c04 843#define EVT_DATAVIEW_ITEM_ACTIVATED(id, fn) wx__DECLARE_DATAVIEWEVT(ITEM_ACTIVATED, id, fn)
6977c3bf 844#define EVT_DATAVIEW_ITEM_COLLAPSING(id, fn) wx__DECLARE_DATAVIEWEVT(ITEM_COLLAPSING, id, fn)
3ecb8a53 845#define EVT_DATAVIEW_ITEM_COLLAPSED(id, fn) wx__DECLARE_DATAVIEWEVT(ITEM_COLLAPSED, id, fn)
6977c3bf 846#define EVT_DATAVIEW_ITEM_EXPANDING(id, fn) wx__DECLARE_DATAVIEWEVT(ITEM_EXPANDING, id, fn)
3ecb8a53 847#define EVT_DATAVIEW_ITEM_EXPANDED(id, fn) wx__DECLARE_DATAVIEWEVT(ITEM_EXPANDED, id, fn)
e0000f94
RR		 848#define EVT_DATAVIEW_ITEM_EDITING_STARTED(id, fn) wx__DECLARE_DATAVIEWEVT(ITEM_EDITING_STARTED, id, fn)
849#define EVT_DATAVIEW_ITEM_EDITING_DONE(id, fn) wx__DECLARE_DATAVIEWEVT(ITEM_EDITING_DONE, id, fn)
6608fdab 850#define EVT_DATAVIEW_ITEM_VALUE_CHANGED(id, fn) wx__DECLARE_DATAVIEWEVT(ITEM_VALUE_CHANGED, id, fn)
e0000f94 851
6af3eec2
RR		 852#define EVT_DATAVIEW_ITEM_CONTEXT_MENU(id, fn) wx__DECLARE_DATAVIEWEVT(ITEM_CONTEXT_MENU, id, fn)
853
31fb32e1
RR		 854#define EVT_DATAVIEW_COLUMN_HEADER_CLICK(id, fn) wx__DECLARE_DATAVIEWEVT(COLUMN_HEADER_CLICK, id, fn)
855#define EVT_DATAVIEW_COLUMN_HEADER_RIGHT_CLICKED(id, fn) wx__DECLARE_DATAVIEWEVT(COLUMN_HEADER_RIGHT_CLICK, id, fn)
c0a66d92 856#define EVT_DATAVIEW_COLUMN_SORTED(id, fn) wx__DECLARE_DATAVIEWEVT(COLUMN_SORTED, id, fn)
e483dfcb 857#define EVT_DATAVIEW_COLUMN_REORDERED(id, fn) wx__DECLARE_DATAVIEWEVT(COLUMN_REORDERED, id, fn)
eb7f97f8 858
4ed7af08
RR		 859#if defined(wxUSE_GENERICDATAVIEWCTRL)
860 #include "wx/generic/dataview.h"
861#elif defined(__WXGTK20__)
bcd846ea
RR		 862 #include "wx/gtk/dataview.h"
863#elif defined(__WXMAC__)
c0a66d92 864 #include "wx/mac/dataview.h"
bcd846ea
RR		 865#else
866 #include "wx/generic/dataview.h"
867#endif
868
52e750fc
RR		 869// -------------------------------------
870// wxDataViewSpinRenderer
871// -------------------------------------
872
4660b556 873class WXDLLIMPEXP_ADV wxDataViewSpinRenderer: public wxDataViewCustomRenderer
52e750fc
RR		 874{
875public:
876 wxDataViewSpinRenderer( int min, int max,
877 wxDataViewCellMode mode = wxDATAVIEW_CELL_EDITABLE,
878 int alignment = wxDVR_DEFAULT_ALIGNMENT );
879 virtual bool HasEditorCtrl() { return true; }
880 virtual wxControl* CreateEditorCtrl( wxWindow *parent, wxRect labelRect, const wxVariant &value );
881 virtual bool GetValueFromEditorCtrl( wxControl* editor, wxVariant &value );
882 virtual bool Render( wxRect rect, wxDC *dc, int state );
883 virtual wxSize GetSize() const;
884 virtual bool SetValue( const wxVariant &value );
885 virtual bool GetValue( wxVariant &value ) const;
b5ec7dd6 886
52e750fc
RR		 887private:
888 long m_data;
889 long m_min,m_max;
890};
891
e94d0c1e
RR		 892//-----------------------------------------------------------------------------
893// wxDataViewTreeStore
894//-----------------------------------------------------------------------------
895
896class WXDLLIMPEXP_ADV wxDataViewTreeStoreNode
897{
898public:
899 wxDataViewTreeStoreNode( wxDataViewTreeStoreNode *parent,
900 const wxString &text, const wxIcon &icon = wxNullIcon, wxClientData *data = NULL );
901 virtual ~wxDataViewTreeStoreNode();
b5ec7dd6
VZ		 902
903 void SetText( const wxString &text )
e94d0c1e
RR		 904 { m_text = text; }
905 wxString GetText() const
906 { return m_text; }
907 void SetIcon( const wxIcon &icon )
908 { m_icon = icon; }
909 const wxIcon &GetIcon() const
910 { return m_icon; }
911 void SetData( wxClientData *data )
912 { if (m_data) delete m_data; m_data = data; }
913 wxClientData *GetData() const
914 { return m_data; }
b5ec7dd6 915
e94d0c1e
RR		 916 wxDataViewItem GetItem() const
917 { return wxDataViewItem( (void*) this ); }
b5ec7dd6 918
e94d0c1e
RR		 919 virtual bool IsContainer()
920 { return false; }
b5ec7dd6 921
e94d0c1e
RR		 922 wxDataViewTreeStoreNode *GetParent()
923 { return m_parent; }
b5ec7dd6 924
e94d0c1e
RR		 925private:
926 wxDataViewTreeStoreNode *m_parent;
927 wxString m_text;
928 wxIcon m_icon;
929 wxClientData *m_data;
930};
931
932WX_DECLARE_LIST_WITH_DECL(wxDataViewTreeStoreNode, wxDataViewTreeStoreNodeList,
933 class WXDLLIMPEXP_ADV);
934
935class WXDLLIMPEXP_ADV wxDataViewTreeStoreContainerNode: public wxDataViewTreeStoreNode
936{
937public:
b5ec7dd6
VZ		 938 wxDataViewTreeStoreContainerNode( wxDataViewTreeStoreNode *parent,
939 const wxString &text, const wxIcon &icon = wxNullIcon, const wxIcon &expanded = wxNullIcon,
e94d0c1e
RR		 940 wxClientData *data = NULL );
941 virtual ~wxDataViewTreeStoreContainerNode();
942
b5ec7dd6 943 const wxDataViewTreeStoreNodeList &GetChildren() const
e94d0c1e 944 { return m_children; }
b5ec7dd6 945 wxDataViewTreeStoreNodeList &GetChildren()
e94d0c1e
RR		 946 { return m_children; }
947
948 void SetExpandedIcon( const wxIcon &icon )
949 { m_iconExpanded = icon; }
950 const wxIcon &GetExpandedIcon() const
951 { return m_iconExpanded; }
b5ec7dd6 952
a75124d0
RR		 953 void SetExpanded( bool expanded = true )
954 { m_isExpanded = expanded; }
955 bool IsExpanded() const
956 { return m_isExpanded; }
957
e94d0c1e
RR		 958 virtual bool IsContainer()
959 { return true; }
b5ec7dd6 960
e94d0c1e
RR		 961private:
962 wxDataViewTreeStoreNodeList m_children;
963 wxIcon m_iconExpanded;
a75124d0 964 bool m_isExpanded;
e94d0c1e
RR		 965};
966
967//-----------------------------------------------------------------------------
968
969class WXDLLIMPEXP_ADV wxDataViewTreeStore: public wxDataViewModel
970{
971public:
972 wxDataViewTreeStore();
973 ~wxDataViewTreeStore();
974
b5ec7dd6 975 wxDataViewItem AppendItem( const wxDataViewItem& parent,
e94d0c1e
RR		 976 const wxString &text, const wxIcon &icon = wxNullIcon, wxClientData *data = NULL );
977 wxDataViewItem PrependItem( const wxDataViewItem& parent,
978 const wxString &text, const wxIcon &icon = wxNullIcon, wxClientData *data = NULL );
979 wxDataViewItem InsertItem( const wxDataViewItem& parent, const wxDataViewItem& previous,
980 const wxString &text, const wxIcon &icon = wxNullIcon, wxClientData *data = NULL );
b5ec7dd6
VZ		 981
982 wxDataViewItem PrependContainer( const wxDataViewItem& parent,
983 const wxString &text, const wxIcon &icon = wxNullIcon, const wxIcon &expanded = wxNullIcon,
e94d0c1e
RR		 984 wxClientData *data = NULL );
985 wxDataViewItem AppendContainer( const wxDataViewItem& parent,
b5ec7dd6 986 const wxString &text, const wxIcon &icon = wxNullIcon, const wxIcon &expanded = wxNullIcon,
e94d0c1e
RR		 987 wxClientData *data = NULL );
988 wxDataViewItem InsertContainer( const wxDataViewItem& parent, const wxDataViewItem& previous,
b5ec7dd6 989 const wxString &text, const wxIcon &icon = wxNullIcon, const wxIcon &expanded = wxNullIcon,
e94d0c1e
RR		 990 wxClientData *data = NULL );
991
992 wxDataViewItem GetNthChild( const wxDataViewItem& parent, unsigned int pos ) const;
993 int GetChildCount( const wxDataViewItem& parent ) const;
b5ec7dd6 994
e94d0c1e
RR		 995 void SetItemText( const wxDataViewItem& item, const wxString &text );
996 wxString GetItemText( const wxDataViewItem& item ) const;
b5ec7dd6 997 void SetItemIcon( const wxDataViewItem& item, const wxIcon &icon );
e94d0c1e
RR		 998 const wxIcon &GetItemIcon( const wxDataViewItem& item ) const;
999 void SetItemExpandedIcon( const wxDataViewItem& item, const wxIcon &icon );
1000 const wxIcon &GetItemExpandedIcon( const wxDataViewItem& item ) const;
1001 void SetItemData( const wxDataViewItem& item, wxClientData *data );
1002 wxClientData *GetItemData( const wxDataViewItem& item ) const;
1003
1004 void DeleteItem( const wxDataViewItem& item );
1005 void DeleteChildren( const wxDataViewItem& item );
1006 void DeleteAllItems();
b5ec7dd6 1007
e94d0c1e
RR		 1008 // implement base methods
1009
b5ec7dd6 1010 virtual void GetValue( wxVariant &variant,
e94d0c1e 1011 const wxDataViewItem &item, unsigned int col ) const;
b5ec7dd6 1012 virtual bool SetValue( const wxVariant &variant,
e94d0c1e
RR		 1013 const wxDataViewItem &item, unsigned int col );
1014 virtual wxDataViewItem GetParent( const wxDataViewItem &item ) const;
1015 virtual bool IsContainer( const wxDataViewItem &item ) const;
1016 virtual unsigned int GetChildren( const wxDataViewItem &item, wxDataViewItemArray &children ) const;
1017
b5ec7dd6 1018 virtual int Compare( const wxDataViewItem &item1, const wxDataViewItem &item2,
e94d0c1e 1019 unsigned int column, bool ascending );
b5ec7dd6
VZ		 1020
1021 virtual bool HasDefaultCompare() const
e94d0c1e 1022 { return true; }
b5ec7dd6 1023 virtual unsigned int GetColumnCount() const
e94d0c1e 1024 { return 1; };
b5ec7dd6 1025 virtual wxString GetColumnType( unsigned int WXUNUSED(col) ) const
594d5596 1026 { return wxT("wxDataViewIconText"); }
b5ec7dd6 1027
e94d0c1e
RR		 1028 wxDataViewTreeStoreNode *FindNode( const wxDataViewItem &item ) const;
1029 wxDataViewTreeStoreContainerNode *FindContainerNode( const wxDataViewItem &item ) const;
1030 wxDataViewTreeStoreNode *GetRoot() const { return m_root; }
b5ec7dd6 1031
e94d0c1e
RR		 1032public:
1033 wxDataViewTreeStoreNode *m_root;
1034};
1035
e94d0c1e
RR		 1036class WXDLLIMPEXP_ADV wxDataViewTreeCtrl: public wxDataViewCtrl
1037{
1038public:
a75124d0
RR		 1039 wxDataViewTreeCtrl();
1040 wxDataViewTreeCtrl( wxWindow *parent, wxWindowID id,
e94d0c1e 1041 const wxPoint& pos = wxDefaultPosition,
1a07a730 1042 const wxSize& size = wxDefaultSize, long style = wxDV_NO_HEADER | wxDV_ROW_LINES,
e94d0c1e 1043 const wxValidator& validator = wxDefaultValidator );
a75124d0 1044 ~wxDataViewTreeCtrl();
e94d0c1e
RR		 1045
1046 bool Create( wxWindow *parent, wxWindowID id,
1047 const wxPoint& pos = wxDefaultPosition,
1a07a730 1048 const wxSize& size = wxDefaultSize, long style = wxDV_NO_HEADER | wxDV_ROW_LINES,
e94d0c1e
RR		 1049 const wxValidator& validator = wxDefaultValidator );
1050
1051 wxDataViewTreeStore *GetStore()
1052 { return (wxDataViewTreeStore*) GetModel(); }
a75124d0
RR		 1053 const wxDataViewTreeStore *GetStore() const
1054 { return (const wxDataViewTreeStore*) GetModel(); }
b5ec7dd6 1055
a75124d0
RR		 1056 void SetImageList( wxImageList *imagelist );
1057 wxImageList* GetImageList() { return m_imageList; }
c058cafa 1058
a75124d0
RR		 1059 wxDataViewItem AppendItem( const wxDataViewItem& parent,
1060 const wxString &text, int icon = -1, wxClientData *data = NULL );
1061 wxDataViewItem PrependItem( const wxDataViewItem& parent,
1062 const wxString &text, int icon = -1, wxClientData *data = NULL );
1063 wxDataViewItem InsertItem( const wxDataViewItem& parent, const wxDataViewItem& previous,
1064 const wxString &text, int icon = -1, wxClientData *data = NULL );
1065
1066 wxDataViewItem PrependContainer( const wxDataViewItem& parent,
1067 const wxString &text, int icon = -1, int expanded = -1,
1068 wxClientData *data = NULL );
1069 wxDataViewItem AppendContainer( const wxDataViewItem& parent,
1070 const wxString &text, int icon = -1, int expanded = -1,
1071 wxClientData *data = NULL );
1072 wxDataViewItem InsertContainer( const wxDataViewItem& parent, const wxDataViewItem& previous,
1073 const wxString &text, int icon = -1, int expanded = -1,
1074 wxClientData *data = NULL );
1075
1076 wxDataViewItem GetNthChild( const wxDataViewItem& parent, unsigned int pos ) const
1077 { return GetStore()->GetNthChild(parent, pos); }
1078 int GetChildCount( const wxDataViewItem& parent ) const
1079 { return GetStore()->GetChildCount(parent); }
1080
1081 void SetItemText( const wxDataViewItem& item, const wxString &text )
1082 { GetStore()->SetItemText(item,text); }
1083 wxString GetItemText( const wxDataViewItem& item ) const
1084 { return GetStore()->GetItemText(item); }
1085 void SetItemIcon( const wxDataViewItem& item, const wxIcon &icon )
1086 { GetStore()->SetItemIcon(item,icon); }
1087 const wxIcon &GetItemIcon( const wxDataViewItem& item ) const
1088 { return GetStore()->GetItemIcon(item); }
1089 void SetItemExpandedIcon( const wxDataViewItem& item, const wxIcon &icon )
1090 { GetStore()->SetItemExpandedIcon(item,icon); }
1091 const wxIcon &GetItemExpandedIcon( const wxDataViewItem& item ) const
1092 { return GetStore()->GetItemExpandedIcon(item); }
1093 void SetItemData( const wxDataViewItem& item, wxClientData *data )
1094 { GetStore()->SetItemData(item,data); }
1095 wxClientData *GetItemData( const wxDataViewItem& item ) const
1096 { return GetStore()->GetItemData(item); }
1097
1098 void DeleteItem( const wxDataViewItem& item )
1099 { GetStore()->DeleteItem(item); }
1100 void DeleteChildren( const wxDataViewItem& item )
1101 { GetStore()->DeleteChildren(item); }
1102 void DeleteAllItems()
1103 { GetStore()->DeleteAllItems(); }
1104
1105 void OnExpanded( wxDataViewEvent &event );
1106 void OnCollapsed( wxDataViewEvent &event );
1a07a730 1107 void OnSize( wxSizeEvent &event );
b5ec7dd6 1108
e94d0c1e 1109private:
a75124d0
RR		 1110 wxImageList *m_imageList;
1111
1112private:
1113 DECLARE_EVENT_TABLE()
e94d0c1e
RR		 1114 DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxDataViewTreeCtrl)
1115};
e94d0c1e 1116
bcd846ea
RR		 1117#endif // wxUSE_DATAVIEWCTRL
1118
1119#endif
1120 // _WX_DATAVIEW_H_BASE_
wxWidgets (Impactor)