Remove SetPageTitle and GetPageTitle and make GetCurrentTitle actually return the...

[wxWidgets.git] / include / wx / generic / headerctrlg.h

diff --git a/include/wx/generic/headerctrlg.h b/include/wx/generic/headerctrlg.h
index 78f8c42a0d7b3c689a77cb3ae34d5bc2c653cf1a..8c9a842d3c5cfd5501395215bb822a813928047e 100644 (file)
--- a/include/wx/generic/headerctrlg.h
+++ b/include/wx/generic/headerctrlg.h
@@ -13,6 +13,7 @@
 
 #include "wx/event.h"
 #include "wx/vector.h"
 
 #include "wx/event.h"
 #include "wx/vector.h"

+#include "wx/overlay.h"

 
 // ----------------------------------------------------------------------------
 // wxHeaderCtrl
 
 // ----------------------------------------------------------------------------
 // wxHeaderCtrl


@@ -49,13 +50,15 @@ public:
 
 private:
     // implement base class pure virtuals
 
 private:
     // implement base class pure virtuals

+    virtual void DoSetCount(unsigned int count);

     virtual unsigned int DoGetCount() const;
     virtual unsigned int DoGetCount() const;

-    virtual void DoInsert(const wxHeaderColumn& col, unsigned int idx);
-    virtual void DoDelete(unsigned int idx);
-    virtual void DoShowColumn(unsigned int idx, bool show);
-    virtual void DoShowSortIndicator(unsigned int idx, int sortOrder);
+    virtual void DoUpdate(unsigned int idx);
+

     virtual void DoScrollHorz(int dx);
 
     virtual void DoScrollHorz(int dx);
 

+    virtual void DoSetColumnsOrder(const wxArrayInt& order);
+    virtual wxArrayInt DoGetColumnsOrder() const;
+

     // override wxWindow methods which must be implemented by a new control
     virtual wxSize DoGetBestSize() const;
 
     // override wxWindow methods which must be implemented by a new control
     virtual wxSize DoGetBestSize() const;
 


@@ -65,38 +68,113 @@ private:
     // event handlers
     void OnPaint(wxPaintEvent& event);
     void OnMouse(wxMouseEvent& event);
     // event handlers
     void OnPaint(wxPaintEvent& event);
     void OnMouse(wxMouseEvent& event);

+    void OnKeyDown(wxKeyEvent& event);
+    void OnCaptureLost(wxMouseCaptureLostEvent& event);
+
+    // move the column with given idx at given position (this doesn't generate
+    // any events but does refresh the display)
+    void DoMoveCol(unsigned int idx, unsigned int pos);

 
 

-    // return the horizontal start position of the given column
+    // return the horizontal start position of the given column in physical
+    // coordinates

     int GetColStart(unsigned int idx) const;
 
     int GetColStart(unsigned int idx) const;
 

-    // refresh the given column [only]
+    // and the end position
+    int GetColEnd(unsigned int idx) const;
+
+    // refresh the given column [only]; idx must be valid

     void RefreshCol(unsigned int idx);
 
     void RefreshCol(unsigned int idx);
 

+    // refresh the given column if idx is valid
+    void RefreshColIfNotNone(unsigned int idx);
+

     // refresh all the controls starting from (and including) the given one
     void RefreshColsAfter(unsigned int idx);
 
     // refresh all the controls starting from (and including) the given one
     void RefreshColsAfter(unsigned int idx);
 

-    // all our current columns
-    typedef wxVector<wxHeaderColumn> Columns;
-    Columns m_cols;
+    // return the column at the given position or -1 if it is beyond the
+    // rightmost column and put true into onSeparator output parameter if the
+    // position is near the divider at the right end of this column (notice
+    // that this means that we return column 0 even if the position is over
+    // column 1 but close enough to the divider separating it from column 0)
+    unsigned int FindColumnAtPoint(int x, bool *onSeparator = NULL) const;
+
+    // return true if a drag resizing operation is currently in progress
+    bool IsResizing() const;

 
 

-    // sorting indicators for the columns: our API is such that it allows using
-    // multiple columns for sorting, and even if this is not used anywhere in
-    // practice right now, still support this
+    // return true if a drag reordering operation is currently in progress
+    bool IsReordering() const;
+
+    // return true if any drag operation is currently in progress
+    bool IsDragging() const { return IsResizing() || IsReordering(); }
+
+    // end any drag operation currently in progress (resizing or reordering)
+    void EndDragging();
+
+    // cancel the drag operation currently in progress and generate an event
+    // about it
+    void CancelDragging();
+
+    // start (if m_colBeingResized is -1) or continue resizing the column

     //
     //

-    // the values are interpreted in the same way as ShowSortIndicator()
-    // sortOrder parameter: true/false for ascending/descending sort if the
-    // corresponding column is used for sorting or -1 otherwise
-    wxVector<int> m_sortOrders;
+    // this generates wxEVT_COMMAND_HEADER_BEGIN_RESIZE/RESIZING events and can
+    // cancel the operation if the user handler decides so
+    void StartOrContinueResizing(unsigned int col, int xPhysical);
+
+    // end the resizing operation currently in progress and generate an event
+    // about it with its cancelled flag set if xPhysical is -1
+    void EndResizing(int xPhysical);
+
+    // same functions as above but for column moving/reordering instead of
+    // resizing
+    void StartReordering(unsigned int col, int xPhysical);
+
+    // returns true if we did drag the column somewhere else or false if we
+    // didn't really move it -- in this case we consider that no reordering
+    // took place and that a normal column click event should be generated
+    bool EndReordering(int xPhysical);
+
+    // constrain the given position to be larger than the start position of the
+    // given column plus its minimal width and return the effective width
+    int ConstrainByMinWidth(unsigned int col, int& xPhysical);
+
+    // update the information displayed while a column is being moved around
+    void UpdateReorderingMarker(int xPhysical);
+
+    // clear any overlaid markers
+    void ClearMarkers();
+
+
+    // number of columns in the control currently
+    unsigned int m_numColumns;

 
     // index of the column under mouse or -1 if none
     unsigned int m_hover;
 
 
     // index of the column under mouse or -1 if none
     unsigned int m_hover;
 

+    // the column being resized or -1 if there is no resizing operation in
+    // progress
+    unsigned int m_colBeingResized;
+
+    // the column being moved or -1 if there is no reordering operation in
+    // progress
+    unsigned int m_colBeingReordered;
+
+    // the distance from the start of m_colBeingReordered and the mouse
+    // position when the user started to drag it
+    int m_dragOffset;
+

     // the horizontal scroll offset
     int m_scrollOffset;
 
     // the horizontal scroll offset
     int m_scrollOffset;
 

+    // the overlay display used during the dragging operations
+    wxOverlay m_overlay;
+
+    // the indices of the column appearing at the given position on the display
+    // (its size is always m_numColumns)
+    wxArrayInt m_colIndices;
+

 
     DECLARE_EVENT_TABLE()
 
     DECLARE_EVENT_TABLE()

-    DECLARE_NO_COPY_CLASS(wxHeaderCtrl)
+    wxDECLARE_NO_COPY_CLASS(wxHeaderCtrl);

 };
 
 #endif // _WX_GENERIC_HEADERCTRLG_H_
 };
 
 #endif // _WX_GENERIC_HEADERCTRLG_H_