include/wx/msw/headerctrl.h

   1 ///////////////////////////////////////////////////////////////////////////////
   2 // Name:        wx/msw/headerctrl.h
   3 // Purpose:     wxMSW native wxHeaderCtrl
   4 // Author:      Vadim Zeitlin
   5 // Created:     2008-12-01
   6 // RCS-ID:      $Id$
   7 // Copyright:   (c) 2008 Vadim Zeitlin <vadim@wxwidgets.org>
   8 // Licence:     wxWindows licence
   9 ///////////////////////////////////////////////////////////////////////////////
  10
  11 #ifndef _WX_MSW_HEADERCTRL_H_
  12 #define _WX_MSW_HEADERCTRL_H_
  13
  14 class WXDLLIMPEXP_FWD_CORE wxImageList;
  15
  16 // ----------------------------------------------------------------------------
  17 // wxHeaderCtrl
  18 // ----------------------------------------------------------------------------
  19
  20 class WXDLLIMPEXP_CORE wxHeaderCtrl : public wxHeaderCtrlBase
  21 {
  22 public:
  23     wxHeaderCtrl()
  24     {
  25         Init();
  26     }
  27
  28     wxHeaderCtrl(wxWindow *parent,
  29                  wxWindowID id = wxID_ANY,
  30                  const wxPoint& pos = wxDefaultPosition,
  31                  const wxSize& size = wxDefaultSize,
  32                  long style = wxHD_DEFAULT_STYLE,
  33                  const wxString& name = wxHeaderCtrlNameStr)
  34     {
  35         Init();
  36
  37         Create(parent, id, pos, size, style, name);
  38     }
  39
  40     bool Create(wxWindow *parent,
  41                 wxWindowID id = wxID_ANY,
  42                 const wxPoint& pos = wxDefaultPosition,
  43                 const wxSize& size = wxDefaultSize,
  44                 long style = wxHD_DEFAULT_STYLE,
  45                 const wxString& name = wxHeaderCtrlNameStr);
  46
  47     virtual ~wxHeaderCtrl();
  48
  49
  50 private:
  51     // implement base class pure virtuals
  52     virtual void DoSetCount(unsigned int count);
  53     virtual unsigned int DoGetCount() const;
  54     virtual void DoUpdate(unsigned int idx);
  55
  56     virtual void DoScrollHorz(int dx);
  57
  58     virtual void DoSetColumnsOrder(const wxArrayInt& order);
  59     virtual wxArrayInt DoGetColumnsOrder() const;
  60
  61     // override wxWindow methods which must be implemented by a new control
  62     virtual wxSize DoGetBestSize() const;
  63     virtual void DoSetSize(int x, int y,
  64                            int width, int height,
  65                            int sizeFlags = wxSIZE_AUTO);
  66
  67     // override MSW-specific methods needed for new control
  68     virtual WXDWORD MSWGetStyle(long style, WXDWORD *exstyle) const;
  69     virtual bool MSWOnNotify(int idCtrl, WXLPARAM lParam, WXLPARAM *result);
  70
  71     // common part of all ctors
  72     void Init();
  73
  74     // wrapper around Header_InsertItem(): insert the item using information
  75     // from the given column at the given index
  76     void DoInsertItem(const wxHeaderColumn& col, unsigned int idx);
  77
  78     // get the number of currently visible items: this is also the total number
  79     // of items contained in the native control
  80     int GetShownColumnsCount() const;
  81
  82     // due to the discrepancy for the hidden columns which we know about but
  83     // the native control does not, there can be a difference between the
  84     // column indices we use and the ones used by the native control; these
  85     // functions translate between them
  86     //
  87     // notice that MSWToNativeIdx() shouldn't be called for hidden columns and
  88     // MSWFromNativeIdx() always returns an index of a visible column
  89     int MSWToNativeIdx(int idx);
  90     int MSWFromNativeIdx(int item);
  91
  92     // this is the same as above but for order, not index
  93     int MSWToNativeOrder(int order);
  94     int MSWFromNativeOrder(int order);
  95
  96     // get the event type corresponding to a click or double click event
  97     // (depending on dblclk value) with the specified (using MSW convention)
  98     // mouse button
  99     wxEventType GetClickEventType(bool dblclk, int button);
 100
 101
 102     // the number of columns in the control, including the hidden ones (not
 103     // taken into account by the native control, see comment in DoGetCount())
 104     unsigned int m_numColumns;
 105
 106     // this is a lookup table allowing us to check whether the column with the
 107     // given index is currently shown in the native control, in which case the
 108     // value of this array element with this index is 0, or hidden
 109     //
 110     // notice that this may be different from GetColumn(idx).IsHidden() and in
 111     // fact we need this array precisely because it will be different from it
 112     // in DoUpdate() when the column hidden flag gets toggled and we need it to
 113     // handle this transition correctly
 114     wxArrayInt m_isHidden;
 115
 116     // the order of our columns: this array contains the index of the column
 117     // shown at the position n as the n-th element
 118     //
 119     // this is necessary only to handle the hidden columns: the native control
 120     // doesn't know about them and so we can't use Header_GetOrderArray()
 121     wxArrayInt m_colIndices;
 122
 123     // the image list: initially NULL, created on demand
 124     wxImageList *m_imageList;
 125
 126     // the offset of the window used to emulate scrolling it
 127     int m_scrollOffset;
 128
 129     wxDECLARE_NO_COPY_CLASS(wxHeaderCtrl);
 130 };
 131
 132 #endif // _WX_MSW_HEADERCTRL_H_
 133