X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/b63f9a33301b1cead8b9ccbb16e2f50b0d82bbe9..c6ea1fdaf924be4ee49a19d12f76e4fcd257bb0a:/include/wx/generic/headerctrlg.h diff --git a/include/wx/generic/headerctrlg.h b/include/wx/generic/headerctrlg.h index 78f8c42a0d..8c9a842d3c 100644 --- 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/overlay.h" // ---------------------------------------------------------------------------- // wxHeaderCtrl @@ -49,13 +50,15 @@ public: 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; @@ -65,38 +68,113 @@ private: // 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 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 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; + // 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) + wxDECLARE_NO_COPY_CLASS(wxHeaderCtrl); }; #endif // _WX_GENERIC_HEADERCTRLG_H_