bar.h 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296
  1. ///////////////////////////////////////////////////////////////////////////////
  2. // Name: wx/ribbon/bar.h
  3. // Purpose: Top-level component of the ribbon-bar-style interface
  4. // Author: Peter Cawley
  5. // Modified by:
  6. // Created: 2009-05-23
  7. // Copyright: (C) Peter Cawley
  8. // Licence: wxWindows licence
  9. ///////////////////////////////////////////////////////////////////////////////
  10. #ifndef _WX_RIBBON_BAR_H_
  11. #define _WX_RIBBON_BAR_H_
  12. #include "wx/defs.h"
  13. #if wxUSE_RIBBON
  14. #include "wx/ribbon/control.h"
  15. #include "wx/ribbon/page.h"
  16. enum wxRibbonBarOption
  17. {
  18. wxRIBBON_BAR_SHOW_PAGE_LABELS = 1 << 0,
  19. wxRIBBON_BAR_SHOW_PAGE_ICONS = 1 << 1,
  20. wxRIBBON_BAR_FLOW_HORIZONTAL = 0,
  21. wxRIBBON_BAR_FLOW_VERTICAL = 1 << 2,
  22. wxRIBBON_BAR_SHOW_PANEL_EXT_BUTTONS = 1 << 3,
  23. wxRIBBON_BAR_SHOW_PANEL_MINIMISE_BUTTONS = 1 << 4,
  24. wxRIBBON_BAR_ALWAYS_SHOW_TABS = 1 << 5,
  25. wxRIBBON_BAR_SHOW_TOGGLE_BUTTON = 1 << 6,
  26. wxRIBBON_BAR_SHOW_HELP_BUTTON = 1 << 7,
  27. wxRIBBON_BAR_DEFAULT_STYLE = wxRIBBON_BAR_FLOW_HORIZONTAL
  28. | wxRIBBON_BAR_SHOW_PAGE_LABELS
  29. | wxRIBBON_BAR_SHOW_PANEL_EXT_BUTTONS
  30. | wxRIBBON_BAR_SHOW_TOGGLE_BUTTON
  31. | wxRIBBON_BAR_SHOW_HELP_BUTTON,
  32. wxRIBBON_BAR_FOLDBAR_STYLE = wxRIBBON_BAR_FLOW_VERTICAL
  33. | wxRIBBON_BAR_SHOW_PAGE_ICONS
  34. | wxRIBBON_BAR_SHOW_PANEL_EXT_BUTTONS
  35. | wxRIBBON_BAR_SHOW_PANEL_MINIMISE_BUTTONS
  36. };
  37. enum wxRibbonDisplayMode
  38. {
  39. wxRIBBON_BAR_PINNED,
  40. wxRIBBON_BAR_MINIMIZED,
  41. wxRIBBON_BAR_EXPANDED
  42. };
  43. class WXDLLIMPEXP_RIBBON wxRibbonBarEvent : public wxNotifyEvent
  44. {
  45. public:
  46. wxRibbonBarEvent(wxEventType command_type = wxEVT_NULL,
  47. int win_id = 0,
  48. wxRibbonPage* page = NULL)
  49. : wxNotifyEvent(command_type, win_id)
  50. , m_page(page)
  51. {
  52. }
  53. #ifndef SWIG
  54. wxRibbonBarEvent(const wxRibbonBarEvent& c) : wxNotifyEvent(c)
  55. {
  56. m_page = c.m_page;
  57. }
  58. #endif
  59. wxEvent *Clone() const { return new wxRibbonBarEvent(*this); }
  60. wxRibbonPage* GetPage() {return m_page;}
  61. void SetPage(wxRibbonPage* page) {m_page = page;}
  62. protected:
  63. wxRibbonPage* m_page;
  64. #ifndef SWIG
  65. private:
  66. DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxRibbonBarEvent)
  67. #endif
  68. };
  69. class WXDLLIMPEXP_RIBBON wxRibbonPageTabInfo
  70. {
  71. public:
  72. wxRect rect;
  73. wxRibbonPage *page;
  74. int ideal_width;
  75. int small_begin_need_separator_width;
  76. int small_must_have_separator_width;
  77. int minimum_width;
  78. bool active;
  79. bool hovered;
  80. bool highlight;
  81. bool shown;
  82. };
  83. #ifndef SWIG
  84. WX_DECLARE_USER_EXPORTED_OBJARRAY(wxRibbonPageTabInfo, wxRibbonPageTabInfoArray, WXDLLIMPEXP_RIBBON);
  85. #endif
  86. class WXDLLIMPEXP_RIBBON wxRibbonBar : public wxRibbonControl
  87. {
  88. public:
  89. wxRibbonBar();
  90. wxRibbonBar(wxWindow* parent,
  91. wxWindowID id = wxID_ANY,
  92. const wxPoint& pos = wxDefaultPosition,
  93. const wxSize& size = wxDefaultSize,
  94. long style = wxRIBBON_BAR_DEFAULT_STYLE);
  95. virtual ~wxRibbonBar();
  96. bool Create(wxWindow* parent,
  97. wxWindowID id = wxID_ANY,
  98. const wxPoint& pos = wxDefaultPosition,
  99. const wxSize& size = wxDefaultSize,
  100. long style = wxRIBBON_BAR_DEFAULT_STYLE);
  101. void SetTabCtrlMargins(int left, int right);
  102. void SetArtProvider(wxRibbonArtProvider* art);
  103. bool SetActivePage(size_t page);
  104. bool SetActivePage(wxRibbonPage* page);
  105. int GetActivePage() const;
  106. wxRibbonPage* GetPage(int n);
  107. size_t GetPageCount() const;
  108. bool DismissExpandedPanel();
  109. int GetPageNumber(wxRibbonPage* page) const;
  110. void DeletePage(size_t n);
  111. void ClearPages();
  112. bool IsPageShown(size_t page) const;
  113. void ShowPage(size_t page, bool show = true);
  114. void HidePage(size_t page) { ShowPage(page, false); }
  115. bool IsPageHighlighted(size_t page) const;
  116. void AddPageHighlight(size_t page, bool highlight = true);
  117. void RemovePageHighlight(size_t page) { AddPageHighlight(page, false); }
  118. void ShowPanels(bool show = true);
  119. void HidePanels() { ShowPanels(false); }
  120. bool ArePanelsShown() const { return m_arePanelsShown; }
  121. virtual bool HasMultiplePages() const { return true; }
  122. void SetWindowStyleFlag(long style);
  123. long GetWindowStyleFlag() const;
  124. virtual bool Realize();
  125. // Implementation only.
  126. bool IsToggleButtonHovered() const { return m_toggle_button_hovered; }
  127. bool IsHelpButtonHovered() const { return m_help_button_hovered; }
  128. void HideIfExpanded();
  129. protected:
  130. friend class wxRibbonPage;
  131. virtual wxSize DoGetBestSize() const;
  132. wxBorder GetDefaultBorder() const { return wxBORDER_NONE; }
  133. wxRibbonPageTabInfo* HitTestTabs(wxPoint position, int* index = NULL);
  134. void HitTestRibbonButton(const wxRect& rect, const wxPoint& position, bool &hover_flag);
  135. void CommonInit(long style);
  136. void AddPage(wxRibbonPage *page);
  137. void RecalculateTabSizes();
  138. void RecalculateMinSize();
  139. void ScrollTabBar(int npixels);
  140. void RefreshTabBar();
  141. void RepositionPage(wxRibbonPage *page);
  142. void OnPaint(wxPaintEvent& evt);
  143. void OnEraseBackground(wxEraseEvent& evt);
  144. void DoEraseBackground(wxDC& dc);
  145. void OnSize(wxSizeEvent& evt);
  146. void OnMouseLeftDown(wxMouseEvent& evt);
  147. void OnMouseLeftUp(wxMouseEvent& evt);
  148. void OnMouseMiddleDown(wxMouseEvent& evt);
  149. void OnMouseMiddleUp(wxMouseEvent& evt);
  150. void OnMouseRightDown(wxMouseEvent& evt);
  151. void OnMouseRightUp(wxMouseEvent& evt);
  152. void OnMouseMove(wxMouseEvent& evt);
  153. void OnMouseLeave(wxMouseEvent& evt);
  154. void OnMouseDoubleClick(wxMouseEvent& evt);
  155. void DoMouseButtonCommon(wxMouseEvent& evt, wxEventType tab_event_type);
  156. void OnKillFocus(wxFocusEvent& evt);
  157. wxRibbonPageTabInfoArray m_pages;
  158. wxRect m_tab_scroll_left_button_rect;
  159. wxRect m_tab_scroll_right_button_rect;
  160. wxRect m_toggle_button_rect;
  161. wxRect m_help_button_rect;
  162. long m_flags;
  163. int m_tabs_total_width_ideal;
  164. int m_tabs_total_width_minimum;
  165. int m_tab_margin_left;
  166. int m_tab_margin_right;
  167. int m_tab_height;
  168. int m_tab_scroll_amount;
  169. int m_current_page;
  170. int m_current_hovered_page;
  171. int m_tab_scroll_left_button_state;
  172. int m_tab_scroll_right_button_state;
  173. bool m_tab_scroll_buttons_shown;
  174. bool m_arePanelsShown;
  175. bool m_bar_hovered;
  176. bool m_toggle_button_hovered;
  177. bool m_help_button_hovered;
  178. wxRibbonDisplayMode m_ribbon_state;
  179. #ifndef SWIG
  180. DECLARE_CLASS(wxRibbonBar)
  181. DECLARE_EVENT_TABLE()
  182. #endif
  183. };
  184. #ifndef SWIG
  185. wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_RIBBON, wxEVT_RIBBONBAR_PAGE_CHANGED, wxRibbonBarEvent);
  186. wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_RIBBON, wxEVT_RIBBONBAR_PAGE_CHANGING, wxRibbonBarEvent);
  187. wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_RIBBON, wxEVT_RIBBONBAR_TAB_MIDDLE_DOWN, wxRibbonBarEvent);
  188. wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_RIBBON, wxEVT_RIBBONBAR_TAB_MIDDLE_UP, wxRibbonBarEvent);
  189. wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_RIBBON, wxEVT_RIBBONBAR_TAB_RIGHT_DOWN, wxRibbonBarEvent);
  190. wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_RIBBON, wxEVT_RIBBONBAR_TAB_RIGHT_UP, wxRibbonBarEvent);
  191. wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_RIBBON, wxEVT_RIBBONBAR_TAB_LEFT_DCLICK, wxRibbonBarEvent);
  192. wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_RIBBON, wxEVT_RIBBONBAR_TOGGLED, wxRibbonBarEvent);
  193. wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_RIBBON, wxEVT_RIBBONBAR_HELP_CLICK, wxRibbonBarEvent);
  194. typedef void (wxEvtHandler::*wxRibbonBarEventFunction)(wxRibbonBarEvent&);
  195. #define wxRibbonBarEventHandler(func) \
  196. wxEVENT_HANDLER_CAST(wxRibbonBarEventFunction, func)
  197. #define EVT_RIBBONBAR_PAGE_CHANGED(winid, fn) \
  198. wx__DECLARE_EVT1(wxEVT_RIBBONBAR_PAGE_CHANGED, winid, wxRibbonBarEventHandler(fn))
  199. #define EVT_RIBBONBAR_PAGE_CHANGING(winid, fn) \
  200. wx__DECLARE_EVT1(wxEVT_RIBBONBAR_PAGE_CHANGING, winid, wxRibbonBarEventHandler(fn))
  201. #define EVT_RIBBONBAR_TAB_MIDDLE_DOWN(winid, fn) \
  202. wx__DECLARE_EVT1(wxEVT_RIBBONBAR_TAB_MIDDLE_DOWN, winid, wxRibbonBarEventHandler(fn))
  203. #define EVT_RIBBONBAR_TAB_MIDDLE_UP(winid, fn) \
  204. wx__DECLARE_EVT1(wxEVT_RIBBONBAR_TAB_MIDDLE_UP, winid, wxRibbonBarEventHandler(fn))
  205. #define EVT_RIBBONBAR_TAB_RIGHT_DOWN(winid, fn) \
  206. wx__DECLARE_EVT1(wxEVT_RIBBONBAR_TAB_RIGHT_DOWN, winid, wxRibbonBarEventHandler(fn))
  207. #define EVT_RIBBONBAR_TAB_RIGHT_UP(winid, fn) \
  208. wx__DECLARE_EVT1(wxEVT_RIBBONBAR_TAB_RIGHT_UP, winid, wxRibbonBarEventHandler(fn))
  209. #define EVT_RIBBONBAR_TAB_LEFT_DCLICK(winid, fn) \
  210. wx__DECLARE_EVT1(wxEVT_RIBBONBAR_TAB_LEFT_DCLICK, winid, wxRibbonBarEventHandler(fn))
  211. #define EVT_RIBBONBAR_TOGGLED(winid, fn) \
  212. wx__DECLARE_EVT1(wxEVT_RIBBONBAR_TOGGLED, winid, wxRibbonBarEventHandler(fn))
  213. #define EVT_RIBBONBAR_HELP_CLICK(winid, fn) \
  214. wx__DECLARE_EVT1(wxEVT_RIBBONBAR_HELP_CLICK, winid, wxRibbonBarEventHandler(fn))
  215. #else
  216. // wxpython/swig event work
  217. %constant wxEventType wxEVT_RIBBONBAR_PAGE_CHANGED;
  218. %constant wxEventType wxEVT_RIBBONBAR_PAGE_CHANGING;
  219. %constant wxEventType wxEVT_RIBBONBAR_TAB_MIDDLE_DOWN;
  220. %constant wxEventType wxEVT_RIBBONBAR_TAB_MIDDLE_UP;
  221. %constant wxEventType wxEVT_RIBBONBAR_TAB_RIGHT_DOWN;
  222. %constant wxEventType wxEVT_RIBBONBAR_TAB_RIGHT_UP;
  223. %constant wxEventType wxEVT_RIBBONBAR_TAB_LEFT_DCLICK;
  224. %constant wxEventType wxEVT_RIBBONBAR_TOGGLED;
  225. %constant wxEventType wxEVT_RIBBONBAR_HELP_CLICK;
  226. %pythoncode {
  227. EVT_RIBBONBAR_PAGE_CHANGED = wx.PyEventBinder( wxEVT_RIBBONBAR_PAGE_CHANGED, 1 )
  228. EVT_RIBBONBAR_PAGE_CHANGING = wx.PyEventBinder( wxEVT_RIBBONBAR_PAGE_CHANGING, 1 )
  229. EVT_RIBBONBAR_TAB_MIDDLE_DOWN = wx.PyEventBinder( wxEVT_RIBBONBAR_TAB_MIDDLE_DOWN, 1 )
  230. EVT_RIBBONBAR_TAB_MIDDLE_UP = wx.PyEventBinder( wxEVT_RIBBONBAR_TAB_MIDDLE_UP, 1 )
  231. EVT_RIBBONBAR_TAB_RIGHT_DOWN = wx.PyEventBinder( wxEVT_RIBBONBAR_TAB_RIGHT_DOWN, 1 )
  232. EVT_RIBBONBAR_TAB_RIGHT_UP = wx.PyEventBinder( wxEVT_RIBBONBAR_TAB_RIGHT_UP, 1 )
  233. EVT_RIBBONBAR_TAB_LEFT_DCLICK = wx.PyEventBinder( wxEVT_RIBBONBAR_TAB_LEFT_DCLICK, 1 )
  234. EVT_RIBBONBAR_TOGGLED = wx.PyEventBinder( wxEVT_RIBBONBAR_TOGGLED, 1 )
  235. EVT_RIBBONBAR_HELP_CLICK = wx.PyEventBinder( wxEVT_RIBBONBAR_HELP_CLICK, 1 )
  236. }
  237. #endif
  238. // old wxEVT_COMMAND_* constants
  239. #define wxEVT_COMMAND_RIBBONBAR_PAGE_CHANGED wxEVT_RIBBONBAR_PAGE_CHANGED
  240. #define wxEVT_COMMAND_RIBBONBAR_PAGE_CHANGING wxEVT_RIBBONBAR_PAGE_CHANGING
  241. #define wxEVT_COMMAND_RIBBONBAR_TAB_MIDDLE_DOWN wxEVT_RIBBONBAR_TAB_MIDDLE_DOWN
  242. #define wxEVT_COMMAND_RIBBONBAR_TAB_MIDDLE_UP wxEVT_RIBBONBAR_TAB_MIDDLE_UP
  243. #define wxEVT_COMMAND_RIBBONBAR_TAB_RIGHT_DOWN wxEVT_RIBBONBAR_TAB_RIGHT_DOWN
  244. #define wxEVT_COMMAND_RIBBONBAR_TAB_RIGHT_UP wxEVT_RIBBONBAR_TAB_RIGHT_UP
  245. #define wxEVT_COMMAND_RIBBONBAR_TAB_LEFT_DCLICK wxEVT_RIBBONBAR_TAB_LEFT_DCLICK
  246. #define wxEVT_COMMAND_RIBBONBAR_TOGGLED wxEVT_RIBBONBAR_TOGGLED
  247. #define wxEVT_COMMAND_RIBBONBAR_HELP_CLICKED wxEVT_RIBBONBAR_HELP_CLICK
  248. #endif // wxUSE_RIBBON
  249. #endif // _WX_RIBBON_BAR_H_