]> git.saurik.com Git - wxWidgets.git/blobdiff - interface/wx/dataview.h
Fixed wxPGMultiButton (event handling, FinalizePosition() -> Finalize(), no longer...
[wxWidgets.git] / interface / wx / dataview.h
index 533e8ec36bd16e4168f98953d333b735a379cdb3..d425872fb4c8e4ee9fb9716eec0256c3f6be2de2 100644 (file)
@@ -8,7 +8,6 @@
 
 /**
     @class wxDataViewIconText
-    @wxheader{dataview.h}
 
     wxDataViewIconText is used by
     wxDataViewIconTextRenderer
@@ -55,7 +54,6 @@ public:
 
 /**
     @class wxDataViewEvent
-    @wxheader{dataview.h}
 
     wxDataViewEvent - the event class for the wxDataViewCtrl notifications
 
@@ -89,7 +87,7 @@ public:
         Returns a pointer to the wxDataViewColumn from which
         the event was emitted or @NULL.
     */
-    wxDataViewColumn* GetDataViewColumn();
+    wxDataViewColumn* GetDataViewColumn() const;
 
     /**
         Returns the wxDataViewModel associated with the event.
@@ -131,7 +129,6 @@ public:
 
 /**
     @class wxDataViewModel
-    @wxheader{dataview.h}
 
     wxDataViewModel is the base class for all data model to be
     displayed by a wxDataViewCtrl.
@@ -397,7 +394,6 @@ public:
 
 /**
     @class wxDataViewIndexListModel
-    @wxheader{dataview.h}
 
     wxDataViewIndexListModel is a specialized data model which lets
     you address an item by its position (row) rather than its
@@ -424,7 +420,7 @@ public:
     /**
         Destructor.
     */
-    ~wxDataViewIndexListModel();
+    virtual ~wxDataViewIndexListModel();
 
     /**
         Compare method that sorts the items by their index.
@@ -514,7 +510,6 @@ public:
 
 /**
     @class wxDataViewVirtualListModel
-    @wxheader{dataview.h}
 
     wxDataViewVirtualListModel is a specialized data model which lets
     you address an item by its position (row) rather than its
@@ -543,7 +538,6 @@ public:
 
 /**
     @class wxDataViewItemAttr
-    @wxheader{dataview.h}
 
     This class is used to indicate to a wxDataViewCtrl
     that a certain Item() has extra font attributes
@@ -585,7 +579,6 @@ public:
 
 /**
     @class wxDataViewItem
-    @wxheader{dataview.h}
 
     wxDataViewItem is a small opaque class that represents an
     item in a wxDataViewCtrl in a
@@ -632,7 +625,6 @@ public:
 
 /**
     @class wxDataViewCtrl
-    @wxheader{dataview.h}
 
     wxDataViewCtrl is a control to display data either
     in a tree like fashion or in a tabular form or both.
@@ -680,6 +672,37 @@ public:
            Allow variable line heights. This can be inefficient when displaying large number of items.
     @endStyleTable
 
+    @beginEventTable{wxDataViewEvent}
+    @event{EVT_DATAVIEW_SELECTION_CHANGED(id, func)}
+           Process a wxEVT_COMMAND_DATAVIEW_SELECTION_CHANGED event.
+    @event{EVT_DATAVIEW_ITEM_ACTIVATED(id, func)}
+           Process a wxEVT_COMMAND_DATAVIEW_ITEM_ACTIVATED event.
+    @event{EVT_DATAVIEW_ITEM_EDITING_STARTED(id, func)}
+           Process a wxEVT_COMMAND_DATAVIEW_ITEM_EDITING_STARTED event.
+    @event{EVT_DATAVIEW_ITEM_EDITING_DONE(id, func)}
+           Process a wxEVT_COMMAND_DATAVIEW_ITEM_EDITING_DONE event.
+    @event{EVT_DATAVIEW_ITEM_COLLAPSING(id, func)}
+           Process a wxEVT_COMMAND_DATAVIEW_ITEM_COLLAPSING event.
+    @event{EVT_DATAVIEW_ITEM_COLLAPSED(id, func)}
+           Process a wxEVT_COMMAND_DATAVIEW_ITEM_COLLAPSED event.
+    @event{EVT_DATAVIEW_ITEM_EXPANDING(id, func)}
+           Process a wxEVT_COMMAND_DATAVIEW_ITEM_EXPANDING event.
+    @event{EVT_DATAVIEW_ITEM_EXPANDED(id, func)}
+           Process a wxEVT_COMMAND_DATAVIEW_ITEM_EXPANDED event.
+    @event{EVT_DATAVIEW_ITEM_VALUE_CHANGED(id, func)}
+           Process a wxEVT_COMMAND_DATAVIEW_ITEM_VALUE_CHANGED event.
+    @event{EVT_DATAVIEW_ITEM_CONTEXT_MENU(id, func)}
+           Process a wxEVT_COMMAND_DATAVIEW_ITEM_CONTEXT_MENU event.
+    @event{EVT_DATAVIEW_COLUMN_HEADER_CLICK(id, func)}
+           Process a wxEVT_COMMAND_DATAVIEW_COLUMN_HEADER_CLICKED event.
+    @event{EVT_DATAVIEW_COLUMN_HEADER_RIGHT_CLICK(id, func)}
+           Process a wxEVT_COMMAND_DATAVIEW_COLUMN_HEADER_RIGHT_CLICKED event.
+    @event{EVT_DATAVIEW_COLUMN_SORTED(id, func)}
+           Process a wxEVT_COMMAND_DATAVIEW_COLUMN_SORTED event.
+    @event{EVT_DATAVIEW_COLUMN_REORDERED(id, func)}
+           Process a wxEVT_COMMAND_DATAVIEW_COLUMN_REORDERED event.
+    @endEventTable
+    
     @library{wxadv}
     @category{ctrl,dvc}
     <!-- @appearance{dataviewctrl.png} -->
@@ -704,7 +727,7 @@ public:
     /**
         Destructor.
     */
-    ~wxDataViewCtrl();
+    virtual ~wxDataViewCtrl();
 
     /**
         Appends a wxDataViewColumn to the control. Returns @true on success.
@@ -874,7 +897,7 @@ public:
     /**
         Collapses the item.
     */
-    void Collapse(const wxDataViewItem& item);
+    virtual void Collapse(const wxDataViewItem& item);
 
     /**
         Create the control. Useful for two step creation.
@@ -899,7 +922,7 @@ public:
     /**
         Expands the item.
     */
-    void Expand(const wxDataViewItem& item);
+    virtual void Expand(const wxDataViewItem& item);
 
     /**
         Returns pointer to the column. @a pos refers to the
@@ -938,18 +961,18 @@ public:
         Returns pointer to the data model associated with the
         control (if any).
     */
-    virtual wxDataViewModel* GetModel() const;
+    wxDataViewModel* GetModel();
 
     /**
         Returns first selected item or an invalid item if none is selected.
     */
-    wxDataViewItem GetSelection() const;
+    virtual wxDataViewItem GetSelection() const;
 
     /**
         Fills @a sel with currently selected items and returns
         their number.
     */
-    int GetSelections(wxDataViewItemArray& sel) const;
+    virtual int GetSelections(wxDataViewItemArray& sel) const;
 
     /**
         Returns the wxDataViewColumn currently responsible for sorting
@@ -966,17 +989,17 @@ public:
     /**
         Return @true if the item is selected.
     */
-    bool IsSelected(const wxDataViewItem& item) const;
+    virtual bool IsSelected(const wxDataViewItem& item) const;
 
     /**
         Select the given item.
     */
-    void Select(const wxDataViewItem& item);
+    virtual void Select(const wxDataViewItem& item);
 
     /**
         Select all items.
     */
-    void SelectAll();
+    virtual void SelectAll();
 
     /**
         Set which column shall contain the tree-like expanders.
@@ -991,25 +1014,24 @@ public:
     /**
         Sets the selection to the array of wxDataViewItems.
     */
-    void SetSelections(const wxDataViewItemArray& sel);
+    virtual void SetSelections(const wxDataViewItemArray& sel);
 
     /**
         Unselect the given item.
     */
-    void Unselect(const wxDataViewItem& item);
+    virtual void Unselect(const wxDataViewItem& item);
 
     /**
         Unselect all item. This method only has effect if multiple
         selections are allowed.
     */
-    void UnselectAll();
+    virtual void UnselectAll();
 };
 
 
 
 /**
     @class wxDataViewModelNotifier
-    @wxheader{dataview.h}
 
     A wxDataViewModelNotifier instance is owned by a
     wxDataViewModel
@@ -1031,7 +1053,7 @@ public:
     /**
         Destructor.
     */
-    ~wxDataViewModelNotifier();
+    virtual ~wxDataViewModelNotifier();
 
     /**
         Called by owning model.
@@ -1069,7 +1091,7 @@ public:
     /**
         Called by owning model.
     */
-    bool ItemsChanged(const wxDataViewItemArray& items);
+    virtual bool ItemsChanged(const wxDataViewItemArray& items);
 
     /**
         Called by owning model.
@@ -1097,7 +1119,6 @@ public:
 
 /**
     @class wxDataViewRenderer
-    @wxheader{dataview.h}
 
     This class is used by wxDataViewCtrl to render the individual cells.
     One instance of a renderer class is owned by a wxDataViewColumn. There
@@ -1169,12 +1190,12 @@ public:
     /**
         Returns the cell mode.
     */
-    virtual wxDataViewCellMode GetMode();
+    virtual wxDataViewCellMode GetMode() const;
 
     /**
         Returns pointer to the owning wxDataViewColumn.
     */
-    virtual wxDataViewColumn* GetOwner() const;
+    wxDataViewColumn* GetOwner() const;
 
     /**
         This methods retrieves the value from the renderer in order to
@@ -1187,7 +1208,7 @@ public:
         Returns a string with the type of the wxVariant
         supported by this renderer.
     */
-    virtual wxString GetVariantType();
+    wxString GetVariantType() const;
 
     /**
         Sets the alignment of the renderer's content. The default value
@@ -1202,7 +1223,7 @@ public:
         Sets the owning wxDataViewColumn. This
         is usually called from within wxDataViewColumn.
     */
-    virtual void SetOwner(wxDataViewColumn* owner);
+    void SetOwner(wxDataViewColumn* owner);
 
     /**
         Set the value of the renderer (and thus its cell) to @e value.
@@ -1228,7 +1249,6 @@ public:
 
 /**
     @class wxDataViewTextRenderer
-    @wxheader{dataview.h}
 
     wxDataViewTextRenderer is used for rendering text. It supports
     in-place editing if desired.
@@ -1251,7 +1271,6 @@ public:
 
 /**
     @class wxDataViewIconTextRenderer
-    @wxheader{dataview.h}
 
     The wxDataViewIconTextRenderer class is used to display text with
     a small icon next to it as it is typically done in a file manager.
@@ -1278,7 +1297,6 @@ public:
 
 /**
     @class wxDataViewProgressRenderer
-    @wxheader{dataview.h}
 
     wxDataViewProgressRenderer
 
@@ -1301,7 +1319,6 @@ public:
 
 /**
     @class wxDataViewSpinRenderer
-    @wxheader{dataview.h}
 
     This is a specialized renderer for rendering integer values. It
     supports modifying the values in-place by using a wxSpinCtrl.
@@ -1326,7 +1343,6 @@ public:
 
 /**
     @class wxDataViewToggleRenderer
-    @wxheader{dataview.h}
 
     wxDataViewToggleRenderer
 
@@ -1347,7 +1363,6 @@ public:
 
 /**
     @class wxDataViewDateRenderer
-    @wxheader{dataview.h}
 
     wxDataViewDateRenderer
 
@@ -1368,7 +1383,6 @@ public:
 
 /**
     @class wxDataViewTextRendererAttr
-    @wxheader{dataview.h}
 
     The same as wxDataViewTextRenderer but with
     support for font attributes. Font attributes are currently only supported
@@ -1395,7 +1409,6 @@ public:
 
 /**
     @class wxDataViewCustomRenderer
-    @wxheader{dataview.h}
 
     You need to derive a new class from wxDataViewCustomRenderer in
     order to write a new renderer. You need to override at least
@@ -1429,7 +1442,7 @@ public:
     /**
         Destructor.
     */
-    ~wxDataViewCustomRenderer();
+    virtual ~wxDataViewCustomRenderer();
 
     /**
         Override this to react to double clicks or ENTER. This method will
@@ -1513,7 +1526,6 @@ public:
 
 /**
     @class wxDataViewBitmapRenderer
-    @wxheader{dataview.h}
 
     wxDataViewBitmapRenderer
 
@@ -1535,7 +1547,6 @@ public:
 
 /**
     @class wxDataViewColumn
-    @wxheader{dataview.h}
 
     This class represents a column in a wxDataViewCtrl.
     One wxDataViewColumn is bound to one column in the data model,
@@ -1571,7 +1582,7 @@ public:
     /**
         Destructor.
     */
-    ~wxDataViewColumn();
+    virtual ~wxDataViewColumn();
 
     /**
         Returns the bitmap in the header of the column, if any.
@@ -1582,7 +1593,7 @@ public:
         Returns the index of the column of the model, which this
         wxDataViewColumn is displaying.
     */
-    unsigned int GetModelColumn();
+    unsigned int GetModelColumn() const;
 
     /**
         Returns the owning wxDataViewCtrl.
@@ -1593,7 +1604,7 @@ public:
         Returns the renderer of this wxDataViewColumn.
         See also wxDataViewRenderer.
     */
-    wxDataViewRenderer* GetRenderer();
+    wxDataViewRenderer* GetRenderer() const;
 
     /**
         Returns @true if the column is reorderable.
@@ -1609,37 +1620,37 @@ public:
     /**
         Returns the width of the column.
     */
-    int GetWidth();
+    virtual int GetWidth() const;
 
     /**
         Returns @true, if the sort order is ascending.
         See also SetSortOrder()
     */
-    bool IsSortOrderAscending();
+    virtual bool IsSortOrderAscending() const;
 
     /**
         Set the alignment of the column header.
     */
-    void SetAlignment(wxAlignment align);
+    virtual void SetAlignment(wxAlignment align);
 
     /**
         Set the bitmap of the column header.
     */
-    void SetBitmap(const wxBitmap& bitmap);
+    virtual void SetBitmap(const wxBitmap& bitmap);
 
     /**
         Indicate wether the column can be reordered by the
         user using the mouse. This is typically implemented
         visually by dragging the header button around.
     */
-    void SetReorderable(bool reorderable);
+    virtual void SetReorderable(bool reorderable);
 
     /**
         Indicate the sort order if the implementation of the
         wxDataViewCtrl supports it, most commonly by showing
         a little arrow.
     */
-    void SetSortOrder(bool ascending);
+    virtual void SetSortOrder(bool ascending);
 
     /**
         Indicate that the column is sortable. This does
@@ -1651,19 +1662,18 @@ public:
         no longer clickable and the sort indicator (little
         arrow) will disappear.
     */
-    void SetSortable(bool sortable);
+    virtual void SetSortable(bool sortable);
 
     /**
         Set the title of the column header to @e title.
     */
-    void SetTitle(const wxString& title);
+    virtual void SetTitle(const wxString& title);
 };
 
 
 
 /**
     @class wxDataViewTreeCtrl
-    @wxheader{dataview.h}
 
     This class is a wxDataViewCtrl which internally
     uses a wxDataViewTreeStore and forwards
@@ -1694,7 +1704,7 @@ public:
     /**
         Destructor. Deletes the image list if any.
     */
-    ~wxDataViewTreeCtrl();
+    virtual ~wxDataViewTreeCtrl();
 
     /**
 
@@ -1854,7 +1864,6 @@ public:
 
 /**
     @class wxDataViewTreeStore
-    @wxheader{dataview.h}
 
     wxDataViewTreeStore is a specialised wxDataViewModel
     for displaying simple trees very much like wxTreeCtrl
@@ -1877,7 +1886,7 @@ public:
     /**
         Destructor.
     */
-    ~wxDataViewTreeStore();
+    virtual ~wxDataViewTreeStore();
 
     /**
         Append a container.