toolbar.h 9.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263
  1. ///////////////////////////////////////////////////////////////////////////////
  2. // Name: wx/ribbon/toolbar.h
  3. // Purpose: Ribbon-style tool bar
  4. // Author: Peter Cawley
  5. // Modified by:
  6. // Created: 2009-07-06
  7. // Copyright: (C) Peter Cawley
  8. // Licence: wxWindows licence
  9. ///////////////////////////////////////////////////////////////////////////////
  10. #ifndef _WX_RIBBON_TOOLBAR_H_
  11. #define _WX_RIBBON_TOOLBAR_H_
  12. #include "wx/defs.h"
  13. #if wxUSE_RIBBON
  14. #include "wx/ribbon/control.h"
  15. #include "wx/ribbon/art.h"
  16. class wxRibbonToolBarToolBase;
  17. class wxRibbonToolBarToolGroup;
  18. WX_DEFINE_USER_EXPORTED_ARRAY_PTR(wxRibbonToolBarToolGroup*, wxArrayRibbonToolBarToolGroup, class WXDLLIMPEXP_RIBBON);
  19. enum wxRibbonToolBarToolState
  20. {
  21. wxRIBBON_TOOLBAR_TOOL_FIRST = 1 << 0,
  22. wxRIBBON_TOOLBAR_TOOL_LAST = 1 << 1,
  23. wxRIBBON_TOOLBAR_TOOL_POSITION_MASK = wxRIBBON_TOOLBAR_TOOL_FIRST | wxRIBBON_TOOLBAR_TOOL_LAST,
  24. wxRIBBON_TOOLBAR_TOOL_NORMAL_HOVERED = 1 << 3,
  25. wxRIBBON_TOOLBAR_TOOL_DROPDOWN_HOVERED = 1 << 4,
  26. wxRIBBON_TOOLBAR_TOOL_HOVER_MASK = wxRIBBON_TOOLBAR_TOOL_NORMAL_HOVERED | wxRIBBON_TOOLBAR_TOOL_DROPDOWN_HOVERED,
  27. wxRIBBON_TOOLBAR_TOOL_NORMAL_ACTIVE = 1 << 5,
  28. wxRIBBON_TOOLBAR_TOOL_DROPDOWN_ACTIVE = 1 << 6,
  29. wxRIBBON_TOOLBAR_TOOL_ACTIVE_MASK = wxRIBBON_TOOLBAR_TOOL_NORMAL_ACTIVE | wxRIBBON_TOOLBAR_TOOL_DROPDOWN_ACTIVE,
  30. wxRIBBON_TOOLBAR_TOOL_DISABLED = 1 << 7,
  31. wxRIBBON_TOOLBAR_TOOL_TOGGLED = 1 << 8,
  32. wxRIBBON_TOOLBAR_TOOL_STATE_MASK = 0x1F8
  33. };
  34. class WXDLLIMPEXP_RIBBON wxRibbonToolBar : public wxRibbonControl
  35. {
  36. public:
  37. wxRibbonToolBar();
  38. wxRibbonToolBar(wxWindow* parent,
  39. wxWindowID id = wxID_ANY,
  40. const wxPoint& pos = wxDefaultPosition,
  41. const wxSize& size = wxDefaultSize,
  42. long style = 0);
  43. virtual ~wxRibbonToolBar();
  44. bool Create(wxWindow* parent,
  45. wxWindowID id = wxID_ANY,
  46. const wxPoint& pos = wxDefaultPosition,
  47. const wxSize& size = wxDefaultSize,
  48. long style = 0);
  49. virtual wxRibbonToolBarToolBase* AddTool(
  50. int tool_id,
  51. const wxBitmap& bitmap,
  52. const wxString& help_string,
  53. wxRibbonButtonKind kind = wxRIBBON_BUTTON_NORMAL);
  54. virtual wxRibbonToolBarToolBase* AddDropdownTool(
  55. int tool_id,
  56. const wxBitmap& bitmap,
  57. const wxString& help_string = wxEmptyString);
  58. virtual wxRibbonToolBarToolBase* AddHybridTool(
  59. int tool_id,
  60. const wxBitmap& bitmap,
  61. const wxString& help_string = wxEmptyString);
  62. virtual wxRibbonToolBarToolBase* AddToggleTool(
  63. int tool_id,
  64. const wxBitmap& bitmap,
  65. const wxString& help_string = wxEmptyString);
  66. virtual wxRibbonToolBarToolBase* AddTool(
  67. int tool_id,
  68. const wxBitmap& bitmap,
  69. const wxBitmap& bitmap_disabled = wxNullBitmap,
  70. const wxString& help_string = wxEmptyString,
  71. wxRibbonButtonKind kind = wxRIBBON_BUTTON_NORMAL,
  72. wxObject* client_data = NULL);
  73. virtual wxRibbonToolBarToolBase* AddSeparator();
  74. virtual wxRibbonToolBarToolBase* InsertTool(
  75. size_t pos,
  76. int tool_id,
  77. const wxBitmap& bitmap,
  78. const wxString& help_string,
  79. wxRibbonButtonKind kind = wxRIBBON_BUTTON_NORMAL);
  80. virtual wxRibbonToolBarToolBase* InsertDropdownTool(
  81. size_t pos,
  82. int tool_id,
  83. const wxBitmap& bitmap,
  84. const wxString& help_string = wxEmptyString);
  85. virtual wxRibbonToolBarToolBase* InsertHybridTool(
  86. size_t pos,
  87. int tool_id,
  88. const wxBitmap& bitmap,
  89. const wxString& help_string = wxEmptyString);
  90. virtual wxRibbonToolBarToolBase* InsertToggleTool(
  91. size_t pos,
  92. int tool_id,
  93. const wxBitmap& bitmap,
  94. const wxString& help_string = wxEmptyString);
  95. virtual wxRibbonToolBarToolBase* InsertTool(
  96. size_t pos,
  97. int tool_id,
  98. const wxBitmap& bitmap,
  99. const wxBitmap& bitmap_disabled = wxNullBitmap,
  100. const wxString& help_string = wxEmptyString,
  101. wxRibbonButtonKind kind = wxRIBBON_BUTTON_NORMAL,
  102. wxObject* client_data = NULL);
  103. virtual wxRibbonToolBarToolBase* InsertSeparator(size_t pos);
  104. virtual void ClearTools();
  105. virtual bool DeleteTool(int tool_id);
  106. virtual bool DeleteToolByPos(size_t pos);
  107. virtual wxRibbonToolBarToolBase* FindById(int tool_id)const;
  108. virtual wxRibbonToolBarToolBase* GetToolByPos(size_t pos)const;
  109. virtual size_t GetToolCount() const;
  110. virtual int GetToolId(const wxRibbonToolBarToolBase* tool)const;
  111. virtual wxObject* GetToolClientData(int tool_id)const;
  112. virtual bool GetToolEnabled(int tool_id)const;
  113. virtual wxString GetToolHelpString(int tool_id)const;
  114. virtual wxRibbonButtonKind GetToolKind(int tool_id)const;
  115. virtual int GetToolPos(int tool_id)const;
  116. virtual bool GetToolState(int tool_id)const;
  117. virtual bool Realize();
  118. virtual void SetRows(int nMin, int nMax = -1);
  119. virtual void SetToolClientData(int tool_id, wxObject* clientData);
  120. virtual void SetToolDisabledBitmap(int tool_id, const wxBitmap &bitmap);
  121. virtual void SetToolHelpString(int tool_id, const wxString& helpString);
  122. virtual void SetToolNormalBitmap(int tool_id, const wxBitmap &bitmap);
  123. virtual bool IsSizingContinuous() const;
  124. virtual void EnableTool(int tool_id, bool enable = true);
  125. virtual void ToggleTool(int tool_id, bool checked);
  126. // Finds the best width and height given the parent's width and height
  127. virtual wxSize GetBestSizeForParentSize(const wxSize& parentSize) const;
  128. protected:
  129. friend class wxRibbonToolBarEvent;
  130. virtual wxSize DoGetBestSize() const;
  131. wxBorder GetDefaultBorder() const { return wxBORDER_NONE; }
  132. void OnEraseBackground(wxEraseEvent& evt);
  133. void OnMouseDown(wxMouseEvent& evt);
  134. void OnMouseEnter(wxMouseEvent& evt);
  135. void OnMouseLeave(wxMouseEvent& evt);
  136. void OnMouseMove(wxMouseEvent& evt);
  137. void OnMouseUp(wxMouseEvent& evt);
  138. void OnPaint(wxPaintEvent& evt);
  139. void OnSize(wxSizeEvent& evt);
  140. virtual wxSize DoGetNextSmallerSize(wxOrientation direction,
  141. wxSize relative_to) const;
  142. virtual wxSize DoGetNextLargerSize(wxOrientation direction,
  143. wxSize relative_to) const;
  144. void CommonInit(long style);
  145. void AppendGroup();
  146. wxRibbonToolBarToolGroup* InsertGroup(size_t pos);
  147. virtual void UpdateWindowUI(long flags);
  148. static wxBitmap MakeDisabledBitmap(const wxBitmap& original);
  149. wxArrayRibbonToolBarToolGroup m_groups;
  150. wxRibbonToolBarToolBase* m_hover_tool;
  151. wxRibbonToolBarToolBase* m_active_tool;
  152. wxSize* m_sizes;
  153. int m_nrows_min;
  154. int m_nrows_max;
  155. #ifndef SWIG
  156. DECLARE_CLASS(wxRibbonToolBar)
  157. DECLARE_EVENT_TABLE()
  158. #endif
  159. };
  160. class WXDLLIMPEXP_RIBBON wxRibbonToolBarEvent : public wxCommandEvent
  161. {
  162. public:
  163. wxRibbonToolBarEvent(wxEventType command_type = wxEVT_NULL,
  164. int win_id = 0,
  165. wxRibbonToolBar* bar = NULL)
  166. : wxCommandEvent(command_type, win_id)
  167. , m_bar(bar)
  168. {
  169. }
  170. #ifndef SWIG
  171. wxRibbonToolBarEvent(const wxRibbonToolBarEvent& e) : wxCommandEvent(e)
  172. {
  173. m_bar = e.m_bar;
  174. }
  175. #endif
  176. wxEvent *Clone() const { return new wxRibbonToolBarEvent(*this); }
  177. wxRibbonToolBar* GetBar() {return m_bar;}
  178. void SetBar(wxRibbonToolBar* bar) {m_bar = bar;}
  179. bool PopupMenu(wxMenu* menu);
  180. protected:
  181. wxRibbonToolBar* m_bar;
  182. #ifndef SWIG
  183. private:
  184. DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxRibbonToolBarEvent)
  185. #endif
  186. };
  187. #ifndef SWIG
  188. wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_RIBBON, wxEVT_RIBBONTOOLBAR_CLICKED, wxRibbonToolBarEvent);
  189. wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_RIBBON, wxEVT_RIBBONTOOLBAR_DROPDOWN_CLICKED, wxRibbonToolBarEvent);
  190. typedef void (wxEvtHandler::*wxRibbonToolBarEventFunction)(wxRibbonToolBarEvent&);
  191. #define wxRibbonToolBarEventHandler(func) \
  192. wxEVENT_HANDLER_CAST(wxRibbonToolBarEventFunction, func)
  193. #define EVT_RIBBONTOOLBAR_CLICKED(winid, fn) \
  194. wx__DECLARE_EVT1(wxEVT_RIBBONTOOLBAR_CLICKED, winid, wxRibbonToolBarEventHandler(fn))
  195. #define EVT_RIBBONTOOLBAR_DROPDOWN_CLICKED(winid, fn) \
  196. wx__DECLARE_EVT1(wxEVT_RIBBONTOOLBAR_DROPDOWN_CLICKED, winid, wxRibbonToolBarEventHandler(fn))
  197. #else
  198. // wxpython/swig event work
  199. %constant wxEventType wxEVT_RIBBONTOOLBAR_CLICKED;
  200. %constant wxEventType wxEVT_RIBBONTOOLBAR_DROPDOWN_CLICKED;
  201. %pythoncode {
  202. EVT_RIBBONTOOLBAR_CLICKED = wx.PyEventBinder( wxEVT_RIBBONTOOLBAR_CLICKED, 1 )
  203. EVT_RIBBONTOOLBAR_DROPDOWN_CLICKED = wx.PyEventBinder( wxEVT_RIBBONTOOLBAR_DROPDOWN_CLICKED, 1 )
  204. }
  205. #endif
  206. // old wxEVT_COMMAND_* constants
  207. #define wxEVT_COMMAND_RIBBONTOOL_CLICKED wxEVT_RIBBONTOOLBAR_CLICKED
  208. #define wxEVT_COMMAND_RIBBONTOOL_DROPDOWN_CLICKED wxEVT_RIBBONTOOLBAR_DROPDOWN_CLICKED
  209. #endif // wxUSE_RIBBON
  210. #endif // _WX_RIBBON_TOOLBAR_H_