include/wx/univ/toolbar.h

   1 ///////////////////////////////////////////////////////////////////////////////
   2 // Name:        wx/univ/toolbar.h
   3 // Purpose:     wxToolBar declaration
   4 // Author:      Robert Roebling
   5 // Modified by:
   6 // Created:     10.09.00
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) Robert Roebling
   9 // Licence:     wxWindows licence
  10 ///////////////////////////////////////////////////////////////////////////////
  11
  12 #ifndef _WX_UNIV_TOOLBAR_H_
  13 #define _WX_UNIV_TOOLBAR_H_
  14
  15 #include "wx/button.h"      // for wxStdButtonInputHandler
  16
  17 class WXDLLEXPORT wxToolBarTool;
  18
  19 // ----------------------------------------------------------------------------
  20 // the actions supported by this control
  21 // ----------------------------------------------------------------------------
  22
  23 #define wxACTION_TOOLBAR_TOGGLE  wxACTION_BUTTON_TOGGLE
  24 #define wxACTION_TOOLBAR_PRESS   wxACTION_BUTTON_PRESS
  25 #define wxACTION_TOOLBAR_RELEASE wxACTION_BUTTON_RELEASE
  26 #define wxACTION_TOOLBAR_CLICK   wxACTION_BUTTON_CLICK
  27 #define wxACTION_TOOLBAR_ENTER   _T("enter")     // highlight the tool
  28 #define wxACTION_TOOLBAR_LEAVE   _T("leave")     // unhighlight the tool
  29
  30 // ----------------------------------------------------------------------------
  31 // wxToolBar
  32 // ----------------------------------------------------------------------------
  33
  34 class WXDLLEXPORT wxToolBar : public wxToolBarBase
  35 {
  36 public:
  37     // construction/destruction
  38     wxToolBar() { Init(); }
  39     wxToolBar(wxWindow *parent,
  40               wxWindowID id,
  41               const wxPoint& pos = wxDefaultPosition,
  42               const wxSize& size = wxDefaultSize,
  43               long style = 0,
  44               const wxString& name = wxToolBarNameStr)
  45     {
  46         Init();
  47
  48         Create(parent, id, pos, size, style, name);
  49     }
  50
  51     bool Create( wxWindow *parent,
  52                  wxWindowID id,
  53                  const wxPoint& pos = wxDefaultPosition,
  54                  const wxSize& size = wxDefaultSize,
  55                  long style = 0,
  56                  const wxString& name = wxToolBarNameStr );
  57
  58     virtual ~wxToolBar();
  59
  60     virtual bool Realize();
  61
  62     virtual void SetWindowStyleFlag( long style );
  63
  64     virtual wxToolBarToolBase *FindToolForPosition(wxCoord x, wxCoord y) const;
  65
  66     virtual void SetToolShortHelp(int id, const wxString& helpString);
  67
  68     virtual void SetMargins(int x, int y);
  69     void SetMargins(const wxSize& size)
  70         { SetMargins((int) size.x, (int) size.y); }
  71
  72     virtual bool PerformAction(const wxControlAction& action,
  73                                long numArg = -1,
  74                                const wxString& strArg = wxEmptyString);
  75     static wxInputHandler *GetStdInputHandler(wxInputHandler *handlerDef);
  76     virtual wxInputHandler *DoGetStdInputHandler(wxInputHandler *handlerDef)
  77     {
  78         return GetStdInputHandler(handlerDef);
  79     }
  80
  81 protected:
  82     // common part of all ctors
  83     void Init();
  84
  85     // implement base class pure virtuals
  86     virtual bool DoInsertTool(size_t pos, wxToolBarToolBase *tool);
  87     virtual bool DoDeleteTool(size_t pos, wxToolBarToolBase *tool);
  88
  89     virtual void DoEnableTool(wxToolBarToolBase *tool, bool enable);
  90     virtual void DoToggleTool(wxToolBarToolBase *tool, bool toggle);
  91     virtual void DoSetToggle(wxToolBarToolBase *tool, bool toggle);
  92
  93     virtual wxToolBarToolBase *CreateTool(int id,
  94                                           const wxString& label,
  95                                           const wxBitmap& bmpNormal,
  96                                           const wxBitmap& bmpDisabled,
  97                                           wxItemKind kind,
  98                                           wxObject *clientData,
  99                                           const wxString& shortHelp,
 100                                           const wxString& longHelp);
 101     virtual wxToolBarToolBase *CreateTool(wxControl *control,
 102                                           const wxString& label);
 103
 104     virtual wxSize DoGetBestClientSize() const;
 105     virtual void DoSetSize(int x, int y,
 106                            int width, int height,
 107                            int sizeFlags = wxSIZE_AUTO);
 108     virtual void DoDraw(wxControlRenderer *renderer);
 109
 110     // get the bounding rect for the given tool
 111     wxRect GetToolRect(wxToolBarToolBase *tool) const;
 112
 113     // redraw the given tool
 114     void RefreshTool(wxToolBarToolBase *tool);
 115
 116     // (re)calculate the tool positions, should only be called if it is
 117     // necessary to do it, i.e. m_needsLayout == true
 118     void DoLayout();
 119
 120     // get the rect limits depending on the orientation: top/bottom for a
 121     // vertical toolbar, left/right for a horizontal one
 122     void GetRectLimits(const wxRect& rect, wxCoord *start, wxCoord *end) const;
 123
 124 private:
 125     // have we calculated the positions of our tools?
 126     bool m_needsLayout;
 127
 128     // the width of a separator
 129     wxCoord m_widthSeparator;
 130
 131     // the total size of all toolbar elements
 132     wxCoord m_maxWidth,
 133             m_maxHeight;
 134
 135 private:
 136     DECLARE_DYNAMIC_CLASS(wxToolBar)
 137 };
 138
 139 #endif // _WX_UNIV_TOOLBAR_H_