include/wx/msw/toolbar.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        wx/msw/tbar95.h
   3 // Purpose:     wxToolBar (Windows 95 toolbar) class
   4 // Author:      Julian Smart
   5 // Modified by:
   6 // Created:     01/02/97
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) Julian Smart
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef _WX_MSW_TBAR95_H_
  13 #define _WX_MSW_TBAR95_H_
  14
  15 #if wxUSE_TOOLBAR
  16
  17 #include "wx/dynarray.h"
  18 #include "wx/imaglist.h"
  19
  20 class WXDLLIMPEXP_CORE wxToolBar : public wxToolBarBase
  21 {
  22 public:
  23     // ctors and dtor
  24     wxToolBar() { Init(); }
  25
  26     wxToolBar(wxWindow *parent,
  27                 wxWindowID id,
  28                 const wxPoint& pos = wxDefaultPosition,
  29                 const wxSize& size = wxDefaultSize,
  30                 long style = wxNO_BORDER | wxTB_HORIZONTAL,
  31                 const wxString& name = wxToolBarNameStr)
  32     {
  33         Init();
  34
  35         Create(parent, id, pos, size, style, name);
  36     }
  37
  38     bool Create(wxWindow *parent,
  39                 wxWindowID id,
  40                 const wxPoint& pos = wxDefaultPosition,
  41                 const wxSize& size = wxDefaultSize,
  42                 long style = wxNO_BORDER | wxTB_HORIZONTAL,
  43                 const wxString& name = wxToolBarNameStr);
  44
  45     virtual ~wxToolBar();
  46
  47     // override/implement base class virtuals
  48     virtual wxToolBarToolBase *FindToolForPosition(wxCoord x, wxCoord y) const;
  49
  50     virtual bool Realize();
  51
  52     virtual void SetToolBitmapSize(const wxSize& size);
  53     virtual wxSize GetToolSize() const;
  54
  55     virtual void SetRows(int nRows);
  56
  57     virtual void SetToolNormalBitmap(int id, const wxBitmap& bitmap);
  58     virtual void SetToolDisabledBitmap(int id, const wxBitmap& bitmap);
  59
  60     // implementation only from now on
  61     // -------------------------------
  62
  63     virtual void SetWindowStyleFlag(long style);
  64
  65     virtual bool MSWCommand(WXUINT param, WXWORD id);
  66     virtual bool MSWOnNotify(int idCtrl, WXLPARAM lParam, WXLPARAM *result);
  67
  68     void OnMouseEvent(wxMouseEvent& event);
  69     void OnSysColourChanged(wxSysColourChangedEvent& event);
  70
  71     void SetFocus() {}
  72
  73     static WXHBITMAP MapBitmap(WXHBITMAP bitmap, int width, int height);
  74
  75     // override WndProc mainly to process WM_SIZE
  76     virtual WXLRESULT MSWWindowProc(WXUINT nMsg, WXWPARAM wParam, WXLPARAM lParam);
  77
  78     virtual WXDWORD MSWGetStyle(long style, WXDWORD *exstyle) const;
  79
  80     // returns true if the platform should explicitly apply a theme border
  81     virtual bool CanApplyThemeBorder() const { return false; }
  82
  83 protected:
  84     // common part of all ctors
  85     void Init();
  86
  87     // create the native toolbar control
  88     bool MSWCreateToolbar(const wxPoint& pos, const wxSize& size);
  89
  90     // recreate the control completely
  91     void Recreate();
  92
  93     // implement base class pure virtuals
  94     virtual bool DoInsertTool(size_t pos, wxToolBarToolBase *tool);
  95     virtual bool DoDeleteTool(size_t pos, wxToolBarToolBase *tool);
  96
  97     virtual void DoEnableTool(wxToolBarToolBase *tool, bool enable);
  98     virtual void DoToggleTool(wxToolBarToolBase *tool, bool toggle);
  99     virtual void DoSetToggle(wxToolBarToolBase *tool, bool toggle);
 100
 101     virtual wxToolBarToolBase *CreateTool(int id,
 102                                           const wxString& label,
 103                                           const wxBitmap& bmpNormal,
 104                                           const wxBitmap& bmpDisabled,
 105                                           wxItemKind kind,
 106                                           wxObject *clientData,
 107                                           const wxString& shortHelp,
 108                                           const wxString& longHelp);
 109
 110     virtual wxToolBarToolBase *CreateTool(wxControl *control,
 111                                           const wxString& label);
 112
 113     // return the appropriate size and flags for the toolbar control
 114     virtual wxSize DoGetBestSize() const;
 115
 116     // handlers for various events
 117     bool HandleSize(WXWPARAM wParam, WXLPARAM lParam);
 118 #ifndef __WXWINCE__
 119     bool HandlePaint(WXWPARAM wParam, WXLPARAM lParam);
 120 #endif // __WXWINCE__
 121     void HandleMouseMove(WXWPARAM wParam, WXLPARAM lParam);
 122
 123     // should be called whenever the toolbar size changes
 124     void UpdateSize();
 125
 126     // create m_disabledImgList (but doesn't fill it), set it to NULL if it is
 127     // unneeded
 128     void CreateDisabledImageList();
 129
 130     // get the Windows toolbar style of this control
 131     long GetMSWToolbarStyle() const;
 132
 133
 134     // the big bitmap containing all bitmaps of the toolbar buttons
 135     WXHBITMAP m_hBitmap;
 136
 137     // the image list with disabled images, may be NULL if we use
 138     // system-provided versions of them
 139     wxImageList *m_disabledImgList;
 140
 141     // the total number of toolbar elements
 142     size_t m_nButtons;
 143
 144     // the sum of the sizes of the fixed items (i.e. excluding stretchable
 145     // spaces) in the toolbar direction
 146     int m_totalFixedSize;
 147
 148     // the tool the cursor is in
 149     wxToolBarToolBase *m_pInTool;
 150
 151 private:
 152     // makes sure tool bitmap size is sufficient for all tools
 153     void AdjustToolBitmapSize();
 154
 155     // update the sizes of stretchable spacers to consume all extra space we
 156     // have
 157     void UpdateStretchableSpacersSize();
 158
 159 #ifndef __WXWINCE__
 160     // redraw the background of the given part of the window to erase separator
 161     // drawn in it
 162     void MSWEraseRect(wxDC& dc, const wxRect& rectItem);
 163 #endif // !__WXWINCE__
 164
 165     DECLARE_EVENT_TABLE()
 166     DECLARE_DYNAMIC_CLASS(wxToolBar)
 167     wxDECLARE_NO_COPY_CLASS(wxToolBar);
 168 };
 169
 170 #endif // wxUSE_TOOLBAR
 171
 172 #endif // _WX_MSW_TBAR95_H_
 173