#include "wx/event.h"
#include "wx/vector.h"
+#include "wx/overlay.h"
// ----------------------------------------------------------------------------
// wxHeaderCtrl
private:
// implement base class pure virtuals
+ virtual void DoSetCount(unsigned int count);
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 DoSetColumnsOrder(const wxArrayInt& order);
+ virtual wxArrayInt DoGetColumnsOrder() const;
+
// override wxWindow methods which must be implemented by a new control
virtual wxSize DoGetBestSize() const;
// 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;
- // 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);
+ // 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);
- // 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 current position of the resizing marker
+ void UpdateResizingMarker(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;
+ // 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 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_NO_COPY_CLASS(wxHeaderCtrl)