1 ///////////////////////////////////////////////////////////////////////////////
2 // Name: src/ribbon/bar.cpp
3 // Purpose: Top-level component of the ribbon-bar-style interface
4 // Author: Peter Cawley
7 // Copyright: (C) Peter Cawley
8 // Licence: wxWindows licence
9 ///////////////////////////////////////////////////////////////////////////////
11 #include "wx/wxprec.h"
19 #include "wx/ribbon/bar.h"
20 #include "wx/ribbon/art.h"
21 #include "wx/dcbuffer.h"
23 #include "wx/vector.h"
29 #include "wx/msw/private.h"
32 #include "wx/arrimpl.cpp"
34 WX_DEFINE_USER_EXPORTED_OBJARRAY(wxRibbonPageTabInfoArray
)
36 wxDEFINE_EVENT(wxEVT_RIBBONBAR_PAGE_CHANGED
, wxRibbonBarEvent
);
37 wxDEFINE_EVENT(wxEVT_RIBBONBAR_PAGE_CHANGING
, wxRibbonBarEvent
);
38 wxDEFINE_EVENT(wxEVT_RIBBONBAR_TAB_MIDDLE_DOWN
, wxRibbonBarEvent
);
39 wxDEFINE_EVENT(wxEVT_RIBBONBAR_TAB_MIDDLE_UP
, wxRibbonBarEvent
);
40 wxDEFINE_EVENT(wxEVT_RIBBONBAR_TAB_RIGHT_DOWN
, wxRibbonBarEvent
);
41 wxDEFINE_EVENT(wxEVT_RIBBONBAR_TAB_RIGHT_UP
, wxRibbonBarEvent
);
42 wxDEFINE_EVENT(wxEVT_RIBBONBAR_TAB_LEFT_DCLICK
, wxRibbonBarEvent
);
43 wxDEFINE_EVENT(wxEVT_RIBBONBAR_TOGGLED
, wxRibbonBarEvent
);
44 wxDEFINE_EVENT(wxEVT_RIBBONBAR_HELP_CLICK
, wxRibbonBarEvent
);
46 IMPLEMENT_CLASS(wxRibbonBar
, wxRibbonControl
)
47 IMPLEMENT_DYNAMIC_CLASS(wxRibbonBarEvent
, wxNotifyEvent
)
49 BEGIN_EVENT_TABLE(wxRibbonBar
, wxRibbonControl
)
50 EVT_ERASE_BACKGROUND(wxRibbonBar::OnEraseBackground
)
51 EVT_LEAVE_WINDOW(wxRibbonBar::OnMouseLeave
)
52 EVT_LEFT_DOWN(wxRibbonBar::OnMouseLeftDown
)
53 EVT_LEFT_UP(wxRibbonBar::OnMouseLeftUp
)
54 EVT_MIDDLE_DOWN(wxRibbonBar::OnMouseMiddleDown
)
55 EVT_MIDDLE_UP(wxRibbonBar::OnMouseMiddleUp
)
56 EVT_MOTION(wxRibbonBar::OnMouseMove
)
57 EVT_PAINT(wxRibbonBar::OnPaint
)
58 EVT_RIGHT_DOWN(wxRibbonBar::OnMouseRightDown
)
59 EVT_RIGHT_UP(wxRibbonBar::OnMouseRightUp
)
60 EVT_LEFT_DCLICK(wxRibbonBar::OnMouseDoubleClick
)
61 EVT_SIZE(wxRibbonBar::OnSize
)
62 EVT_KILL_FOCUS(wxRibbonBar::OnKillFocus
)
65 void wxRibbonBar::AddPage(wxRibbonPage
*page
)
67 wxRibbonPageTabInfo info
;
72 info
.highlight
= false;
74 // info.rect not set (intentional)
76 wxClientDC
dcTemp(this);
77 wxString label
= wxEmptyString
;
78 if(m_flags
& wxRIBBON_BAR_SHOW_PAGE_LABELS
)
79 label
= page
->GetLabel();
80 wxBitmap icon
= wxNullBitmap
;
81 if(m_flags
& wxRIBBON_BAR_SHOW_PAGE_ICONS
)
82 icon
= page
->GetIcon();
83 m_art
->GetBarTabWidth(dcTemp
, this, label
, icon
,
85 &info
.small_begin_need_separator_width
,
86 &info
.small_must_have_separator_width
,
91 m_tabs_total_width_ideal
= info
.ideal_width
;
92 m_tabs_total_width_minimum
= info
.minimum_width
;
96 int sep
= m_art
->GetMetric(wxRIBBON_ART_TAB_SEPARATION_SIZE
);
97 m_tabs_total_width_ideal
+= sep
+ info
.ideal_width
;
98 m_tabs_total_width_minimum
+= sep
+ info
.minimum_width
;
102 page
->Hide(); // Most likely case is that this new page is not the active tab
103 page
->SetArtProvider(m_art
);
105 if(m_pages
.GetCount() == 1)
107 SetActivePage((size_t)0);
111 bool wxRibbonBar::DismissExpandedPanel()
113 if(m_current_page
== -1)
115 return m_pages
.Item(m_current_page
).page
->DismissExpandedPanel();
118 void wxRibbonBar::ShowPanels(bool show
)
120 m_arePanelsShown
= show
;
121 SetMinSize(wxSize(GetSize().GetWidth(), DoGetBestSize().GetHeight()));
123 GetParent()->Layout();
126 void wxRibbonBar::SetWindowStyleFlag(long style
)
130 m_art
->SetFlags(style
);
133 long wxRibbonBar::GetWindowStyleFlag() const
138 bool wxRibbonBar::Realize()
142 wxClientDC
dcTemp(this);
143 int sep
= m_art
->GetMetric(wxRIBBON_ART_TAB_SEPARATION_SIZE
);
144 size_t numtabs
= m_pages
.GetCount();
146 for(i
= 0; i
< numtabs
; ++i
)
148 wxRibbonPageTabInfo
& info
= m_pages
.Item(i
);
151 RepositionPage(info
.page
);
152 if(!info
.page
->Realize())
156 wxString label
= wxEmptyString
;
157 if(m_flags
& wxRIBBON_BAR_SHOW_PAGE_LABELS
)
158 label
= info
.page
->GetLabel();
159 wxBitmap icon
= wxNullBitmap
;
160 if(m_flags
& wxRIBBON_BAR_SHOW_PAGE_ICONS
)
161 icon
= info
.page
->GetIcon();
162 m_art
->GetBarTabWidth(dcTemp
, this, label
, icon
,
164 &info
.small_begin_need_separator_width
,
165 &info
.small_must_have_separator_width
,
166 &info
.minimum_width
);
170 m_tabs_total_width_ideal
= info
.ideal_width
;
171 m_tabs_total_width_minimum
= info
.minimum_width
;
175 m_tabs_total_width_ideal
+= sep
+ info
.ideal_width
;
176 m_tabs_total_width_minimum
+= sep
+ info
.minimum_width
;
179 m_tab_height
= m_art
->GetTabCtrlHeight(dcTemp
, this, m_pages
);
181 RecalculateMinSize();
182 RecalculateTabSizes();
188 void wxRibbonBar::OnMouseMove(wxMouseEvent
& evt
)
192 int hovered_page
= -1;
193 bool refresh_tabs
= false;
196 // It is quite likely that the mouse moved a small amount and is still over the same tab
197 if(m_current_hovered_page
!= -1 && m_pages
.Item((size_t)m_current_hovered_page
).rect
.Contains(x
, y
))
199 hovered_page
= m_current_hovered_page
;
200 // But be careful, if tabs can be scrolled, then parts of the tab rect may not be valid
201 if(m_tab_scroll_buttons_shown
)
203 if(x
>= m_tab_scroll_right_button_rect
.GetX() || x
< m_tab_scroll_left_button_rect
.GetRight())
211 HitTestTabs(evt
.GetPosition(), &hovered_page
);
214 if(hovered_page
!= m_current_hovered_page
)
216 if(m_current_hovered_page
!= -1)
218 m_pages
.Item((int)m_current_hovered_page
).hovered
= false;
220 m_current_hovered_page
= hovered_page
;
221 if(m_current_hovered_page
!= -1)
223 m_pages
.Item((int)m_current_hovered_page
).hovered
= true;
227 if(m_tab_scroll_buttons_shown
)
229 #define SET_FLAG(variable, flag) \
230 { if(((variable) & (flag)) != (flag)) { variable |= (flag); refresh_tabs = true; }}
231 #define UNSET_FLAG(variable, flag) \
232 { if((variable) & (flag)) { variable &= ~(flag); refresh_tabs = true; }}
234 if(m_tab_scroll_left_button_rect
.Contains(x
, y
))
235 SET_FLAG(m_tab_scroll_left_button_state
, wxRIBBON_SCROLL_BTN_HOVERED
)
237 UNSET_FLAG(m_tab_scroll_left_button_state
, wxRIBBON_SCROLL_BTN_HOVERED
)
239 if(m_tab_scroll_right_button_rect
.Contains(x
, y
))
240 SET_FLAG(m_tab_scroll_right_button_state
, wxRIBBON_SCROLL_BTN_HOVERED
)
242 UNSET_FLAG(m_tab_scroll_right_button_state
, wxRIBBON_SCROLL_BTN_HOVERED
)
250 if ( m_flags
& wxRIBBON_BAR_SHOW_TOGGLE_BUTTON
)
251 HitTestRibbonButton(m_toggle_button_rect
, evt
.GetPosition(), m_toggle_button_hovered
);
252 if ( m_flags
& wxRIBBON_BAR_SHOW_HELP_BUTTON
)
253 HitTestRibbonButton(m_help_button_rect
, evt
.GetPosition(), m_help_button_hovered
);
256 void wxRibbonBar::OnMouseLeave(wxMouseEvent
& WXUNUSED(evt
))
258 // The ribbon bar is (usually) at the top of a window, and at least on MSW, the mouse
259 // can leave the window quickly and leave a tab in the hovered state.
260 bool refresh_tabs
= false;
261 if(m_current_hovered_page
!= -1)
263 m_pages
.Item((int)m_current_hovered_page
).hovered
= false;
264 m_current_hovered_page
= -1;
267 if(m_tab_scroll_left_button_state
& wxRIBBON_SCROLL_BTN_HOVERED
)
269 m_tab_scroll_left_button_state
&= ~wxRIBBON_SCROLL_BTN_HOVERED
;
272 if(m_tab_scroll_right_button_state
& wxRIBBON_SCROLL_BTN_HOVERED
)
274 m_tab_scroll_right_button_state
&= ~wxRIBBON_SCROLL_BTN_HOVERED
;
281 if(m_toggle_button_hovered
)
283 m_bar_hovered
= false;
284 m_toggle_button_hovered
= false;
287 if ( m_help_button_hovered
)
289 m_help_button_hovered
= false;
290 m_bar_hovered
= false;
295 wxRibbonPage
* wxRibbonBar::GetPage(int n
)
297 if(n
< 0 || (size_t)n
>= m_pages
.GetCount())
299 return m_pages
.Item(n
).page
;
302 size_t wxRibbonBar::GetPageCount() const
304 return m_pages
.GetCount();
307 bool wxRibbonBar::IsPageShown(size_t page
) const
309 if (page
>= m_pages
.GetCount())
311 return m_pages
.Item(page
).shown
;
314 void wxRibbonBar::ShowPage(size_t page
, bool show
)
316 if(page
>= m_pages
.GetCount())
318 m_pages
.Item(page
).shown
= show
;
321 bool wxRibbonBar::IsPageHighlighted(size_t page
) const
323 if (page
>= m_pages
.GetCount())
325 return m_pages
.Item(page
).highlight
;
328 void wxRibbonBar::AddPageHighlight(size_t page
, bool highlight
)
330 if(page
>= m_pages
.GetCount())
332 m_pages
.Item(page
).highlight
= highlight
;
335 void wxRibbonBar::DeletePage(size_t n
)
337 if(n
< m_pages
.GetCount())
339 wxRibbonPage
*page
= m_pages
.Item(n
).page
;
341 // Schedule page object for destruction and not destroying directly
342 // as this function can be called in an event handler and page functions
343 // can be called afeter removing.
344 // Like in wxRibbonButtonBar::OnMouseUp
345 if(!wxTheApp
->IsScheduledForDestruction(page
))
347 wxTheApp
->ScheduleForDestruction(page
);
352 if(m_current_page
== static_cast<int>(n
))
356 if(m_pages
.GetCount() > 0)
358 if(n
>= m_pages
.GetCount())
360 SetActivePage(m_pages
.GetCount() - 1);
364 SetActivePage(n
- 1);
368 else if(m_current_page
> static_cast<int>(n
))
375 void wxRibbonBar::ClearPages()
378 for(i
=0; i
<m_pages
.GetCount(); i
++)
380 wxRibbonPage
*page
= m_pages
.Item(i
).page
;
381 // Schedule page object for destruction and not destroying directly
382 // as this function can be called in an event handler and page functions
383 // can be called afeter removing.
384 // Like in wxRibbonButtonBar::OnMouseUp
385 if(!wxTheApp
->IsScheduledForDestruction(page
))
387 wxTheApp
->ScheduleForDestruction(page
);
396 bool wxRibbonBar::SetActivePage(size_t page
)
398 if(m_current_page
== (int)page
)
403 if(page
>= m_pages
.GetCount())
408 if(m_current_page
!= -1)
410 m_pages
.Item((size_t)m_current_page
).active
= false;
411 m_pages
.Item((size_t)m_current_page
).page
->Hide();
413 m_current_page
= (int)page
;
414 m_pages
.Item(page
).active
= true;
415 m_pages
.Item(page
).shown
= true;
417 wxRibbonPage
* wnd
= m_pages
.Item(page
).page
;
427 bool wxRibbonBar::SetActivePage(wxRibbonPage
* page
)
429 size_t numpages
= m_pages
.GetCount();
431 for(i
= 0; i
< numpages
; ++i
)
433 if(m_pages
.Item(i
).page
== page
)
435 return SetActivePage(i
);
441 int wxRibbonBar::GetPageNumber(wxRibbonPage
* page
) const
443 size_t numpages
= m_pages
.GetCount();
444 for(size_t i
= 0; i
< numpages
; ++i
)
446 if(m_pages
.Item(i
).page
== page
)
455 int wxRibbonBar::GetActivePage() const
457 return m_current_page
;
460 void wxRibbonBar::SetTabCtrlMargins(int left
, int right
)
462 m_tab_margin_left
= left
;
463 m_tab_margin_right
= right
;
465 RecalculateTabSizes();
468 struct PageComparedBySmallWidthAsc
470 wxEXPLICIT
PageComparedBySmallWidthAsc(wxRibbonPageTabInfo
* page
)
475 bool operator<(const PageComparedBySmallWidthAsc
& other
) const
477 return m_page
->small_must_have_separator_width
478 < other
.m_page
->small_must_have_separator_width
;
481 wxRibbonPageTabInfo
*m_page
;
484 void wxRibbonBar::RecalculateTabSizes()
486 size_t numtabs
= m_pages
.GetCount();
491 int width
= GetSize().GetWidth() - m_tab_margin_left
- m_tab_margin_right
;
492 int tabsep
= m_art
->GetMetric(wxRIBBON_ART_TAB_SEPARATION_SIZE
);
493 int x
= m_tab_margin_left
;
496 if(width
>= m_tabs_total_width_ideal
)
498 // Simple case: everything at ideal width
500 for(i
= 0; i
< numtabs
; ++i
)
502 wxRibbonPageTabInfo
& info
= m_pages
.Item(i
);
507 info
.rect
.width
= info
.ideal_width
;
508 info
.rect
.height
= m_tab_height
;
509 x
+= info
.rect
.width
+ tabsep
;
511 m_tab_scroll_buttons_shown
= false;
512 m_tab_scroll_left_button_rect
.SetWidth(0);
513 m_tab_scroll_right_button_rect
.SetWidth(0);
515 else if(width
< m_tabs_total_width_minimum
)
517 // Simple case: everything minimum with scrollbar
519 for(i
= 0; i
< numtabs
; ++i
)
521 wxRibbonPageTabInfo
& info
= m_pages
.Item(i
);
526 info
.rect
.width
= info
.minimum_width
;
527 info
.rect
.height
= m_tab_height
;
528 x
+= info
.rect
.width
+ tabsep
;
530 if(!m_tab_scroll_buttons_shown
)
532 m_tab_scroll_left_button_state
= wxRIBBON_SCROLL_BTN_NORMAL
;
533 m_tab_scroll_right_button_state
= wxRIBBON_SCROLL_BTN_NORMAL
;
534 m_tab_scroll_buttons_shown
= true;
537 wxClientDC
temp_dc(this);
538 int right_button_pos
= GetClientSize().GetWidth() - m_tab_margin_right
- m_tab_scroll_right_button_rect
.GetWidth();
539 if ( right_button_pos
< m_tab_margin_left
)
540 right_button_pos
= m_tab_margin_left
;
542 m_tab_scroll_left_button_rect
.SetWidth(m_art
->GetScrollButtonMinimumSize(temp_dc
, this, wxRIBBON_SCROLL_BTN_LEFT
| wxRIBBON_SCROLL_BTN_NORMAL
| wxRIBBON_SCROLL_BTN_FOR_TABS
).GetWidth());
543 m_tab_scroll_left_button_rect
.SetHeight(m_tab_height
);
544 m_tab_scroll_left_button_rect
.SetX(m_tab_margin_left
);
545 m_tab_scroll_left_button_rect
.SetY(0);
546 m_tab_scroll_right_button_rect
.SetWidth(m_art
->GetScrollButtonMinimumSize(temp_dc
, this, wxRIBBON_SCROLL_BTN_RIGHT
| wxRIBBON_SCROLL_BTN_NORMAL
| wxRIBBON_SCROLL_BTN_FOR_TABS
).GetWidth());
547 m_tab_scroll_right_button_rect
.SetHeight(m_tab_height
);
548 m_tab_scroll_right_button_rect
.SetX(right_button_pos
);
549 m_tab_scroll_right_button_rect
.SetY(0);
551 if(m_tab_scroll_amount
== 0)
553 m_tab_scroll_left_button_rect
.SetWidth(0);
555 else if(m_tab_scroll_amount
+ width
>= m_tabs_total_width_minimum
)
557 m_tab_scroll_amount
= m_tabs_total_width_minimum
- width
;
558 m_tab_scroll_right_button_rect
.SetX(m_tab_scroll_right_button_rect
.GetX() + m_tab_scroll_right_button_rect
.GetWidth());
559 m_tab_scroll_right_button_rect
.SetWidth(0);
561 for(i
= 0; i
< numtabs
; ++i
)
563 wxRibbonPageTabInfo
& info
= m_pages
.Item(i
);
566 info
.rect
.x
-= m_tab_scroll_amount
;
571 m_tab_scroll_buttons_shown
= false;
572 m_tab_scroll_left_button_rect
.SetWidth(0);
573 m_tab_scroll_right_button_rect
.SetWidth(0);
574 // Complex case: everything sized such that: minimum <= width < ideal
577 1) Uniformly reduce all tab widths from ideal to small_must_have_separator_width
578 2) Reduce the largest tab by 1 pixel, repeating until all tabs are same width (or at minimum)
579 3) Uniformly reduce all tabs down to their minimum width
581 int smallest_tab_width
= INT_MAX
;
582 int total_small_width
= tabsep
* (numtabs
- 1);
584 for(i
= 0; i
< numtabs
; ++i
)
586 wxRibbonPageTabInfo
& info
= m_pages
.Item(i
);
589 if(info
.small_must_have_separator_width
< smallest_tab_width
)
591 smallest_tab_width
= info
.small_must_have_separator_width
;
593 total_small_width
+= info
.small_must_have_separator_width
;
595 if(width
>= total_small_width
)
598 int total_delta
= m_tabs_total_width_ideal
- total_small_width
;
599 total_small_width
-= tabsep
* (numtabs
- 1);
600 width
-= tabsep
* (numtabs
- 1);
601 for(i
= 0; i
< numtabs
; ++i
)
603 wxRibbonPageTabInfo
& info
= m_pages
.Item(i
);
606 int delta
= info
.ideal_width
- info
.small_must_have_separator_width
;
609 info
.rect
.width
= info
.small_must_have_separator_width
+ delta
* (width
- total_small_width
) / total_delta
;
610 info
.rect
.height
= m_tab_height
;
612 x
+= info
.rect
.width
+ tabsep
;
613 total_delta
-= delta
;
614 total_small_width
-= info
.small_must_have_separator_width
;
615 width
-= info
.rect
.width
;
620 total_small_width
= tabsep
* (numtabs
- 1);
621 for(i
= 0; i
< numtabs
; ++i
)
623 wxRibbonPageTabInfo
& info
= m_pages
.Item(i
);
626 if(info
.minimum_width
< smallest_tab_width
)
628 total_small_width
+= smallest_tab_width
;
632 total_small_width
+= info
.minimum_width
;
635 if(width
>= total_small_width
)
638 wxVector
<PageComparedBySmallWidthAsc
> sorted_pages
;
639 sorted_pages
.reserve(numtabs
);
640 for ( i
= 0; i
< numtabs
; ++i
)
641 sorted_pages
.push_back(PageComparedBySmallWidthAsc(&m_pages
.Item(i
)));
643 wxVectorSort(sorted_pages
);
644 width
-= tabsep
* (numtabs
- 1);
645 for(i
= 0; i
< numtabs
; ++i
)
647 wxRibbonPageTabInfo
* info
= sorted_pages
[i
].m_page
;
650 if(info
->small_must_have_separator_width
* (int)(numtabs
- i
) <= width
)
652 info
->rect
.width
= info
->small_must_have_separator_width
;;
656 info
->rect
.width
= width
/ (numtabs
- i
);
658 width
-= info
->rect
.width
;
660 for(i
= 0; i
< numtabs
; ++i
)
662 wxRibbonPageTabInfo
& info
= m_pages
.Item(i
);
667 info
.rect
.height
= m_tab_height
;
668 x
+= info
.rect
.width
+ tabsep
;
674 total_small_width
= (smallest_tab_width
+ tabsep
) * numtabs
- tabsep
;
675 int total_delta
= total_small_width
- m_tabs_total_width_minimum
;
676 total_small_width
= m_tabs_total_width_minimum
- tabsep
* (numtabs
- 1);
677 width
-= tabsep
* (numtabs
- 1);
678 for(i
= 0; i
< numtabs
; ++i
)
680 wxRibbonPageTabInfo
& info
= m_pages
.Item(i
);
683 int delta
= smallest_tab_width
- info
.minimum_width
;
686 info
.rect
.width
= info
.minimum_width
+ delta
* (width
- total_small_width
) / total_delta
;
687 info
.rect
.height
= m_tab_height
;
689 x
+= info
.rect
.width
+ tabsep
;
690 total_delta
-= delta
;
691 total_small_width
-= info
.minimum_width
;
692 width
-= info
.rect
.width
;
699 wxRibbonBar::wxRibbonBar()
702 m_tabs_total_width_ideal
= 0;
703 m_tabs_total_width_minimum
= 0;
704 m_tab_margin_left
= 0;
705 m_tab_margin_right
= 0;
707 m_tab_scroll_amount
= 0;
709 m_current_hovered_page
= -1;
710 m_tab_scroll_left_button_state
= wxRIBBON_SCROLL_BTN_NORMAL
;
711 m_tab_scroll_right_button_state
= wxRIBBON_SCROLL_BTN_NORMAL
;
712 m_tab_scroll_buttons_shown
= false;
713 m_arePanelsShown
= true;
714 m_help_button_hovered
= false;
717 wxRibbonBar::wxRibbonBar(wxWindow
* parent
,
722 : wxRibbonControl(parent
, id
, pos
, size
, wxBORDER_NONE
)
727 wxRibbonBar::~wxRibbonBar()
729 SetArtProvider(NULL
);
732 bool wxRibbonBar::Create(wxWindow
* parent
,
738 if(!wxRibbonControl::Create(parent
, id
, pos
, size
, wxBORDER_NONE
))
746 void wxRibbonBar::CommonInit(long style
)
748 SetName(wxT("wxRibbonBar"));
751 m_tabs_total_width_ideal
= 0;
752 m_tabs_total_width_minimum
= 0;
753 m_tab_margin_left
= 50;
754 m_tab_margin_right
= 20;
755 if ( m_flags
& wxRIBBON_BAR_SHOW_TOGGLE_BUTTON
)
756 m_tab_margin_right
+= 20;
757 if ( m_flags
& wxRIBBON_BAR_SHOW_HELP_BUTTON
)
758 m_tab_margin_right
+= 20;
759 m_tab_height
= 20; // initial guess
760 m_tab_scroll_amount
= 0;
762 m_current_hovered_page
= -1;
763 m_tab_scroll_left_button_state
= wxRIBBON_SCROLL_BTN_NORMAL
;
764 m_tab_scroll_right_button_state
= wxRIBBON_SCROLL_BTN_NORMAL
;
765 m_tab_scroll_buttons_shown
= false;
766 m_arePanelsShown
= true;
770 SetArtProvider(new wxRibbonDefaultArtProvider
);
772 SetBackgroundStyle(wxBG_STYLE_CUSTOM
);
774 m_toggle_button_hovered
= false;
775 m_bar_hovered
= false;
777 m_ribbon_state
= wxRIBBON_BAR_PINNED
;
780 void wxRibbonBar::SetArtProvider(wxRibbonArtProvider
* art
)
782 wxRibbonArtProvider
*old
= m_art
;
787 art
->SetFlags(m_flags
);
789 size_t numpages
= m_pages
.GetCount();
791 for(i
= 0; i
< numpages
; ++i
)
793 wxRibbonPage
*page
= m_pages
.Item(i
).page
;
794 if(page
->GetArtProvider() != art
)
796 page
->SetArtProvider(art
);
803 void wxRibbonBar::OnPaint(wxPaintEvent
& WXUNUSED(evt
))
805 wxAutoBufferedPaintDC
dc(this);
807 if(GetUpdateRegion().Contains(0, 0, GetClientSize().GetWidth(), m_tab_height
) == wxOutRegion
)
809 // Nothing to do in the tab area, and the page area is handled by the active page
813 DoEraseBackground(dc
);
815 if ( m_flags
& wxRIBBON_BAR_SHOW_HELP_BUTTON
)
816 m_help_button_rect
= m_art
->GetRibbonHelpButtonArea(GetSize());
817 if ( m_flags
& wxRIBBON_BAR_SHOW_TOGGLE_BUTTON
)
818 m_toggle_button_rect
= m_art
->GetBarToggleButtonArea(GetSize());
820 size_t numtabs
= m_pages
.GetCount();
821 double sep_visibility
= 0.0;
822 bool draw_sep
= false;
823 wxRect
tabs_rect(m_tab_margin_left
, 0, GetClientSize().GetWidth() - m_tab_margin_left
- m_tab_margin_right
, m_tab_height
);
824 if(m_tab_scroll_buttons_shown
)
826 tabs_rect
.x
+= m_tab_scroll_left_button_rect
.GetWidth();
827 tabs_rect
.width
-= m_tab_scroll_left_button_rect
.GetWidth() + m_tab_scroll_right_button_rect
.GetWidth();
830 for(i
= 0; i
< numtabs
; ++i
)
832 wxRibbonPageTabInfo
& info
= m_pages
.Item(i
);
836 dc
.DestroyClippingRegion();
837 if(m_tab_scroll_buttons_shown
)
839 if(!tabs_rect
.Intersects(info
.rect
))
841 dc
.SetClippingRegion(tabs_rect
);
843 dc
.SetClippingRegion(info
.rect
);
844 m_art
->DrawTab(dc
, this, info
);
846 if(info
.rect
.width
< info
.small_begin_need_separator_width
)
849 if(info
.rect
.width
< info
.small_must_have_separator_width
)
851 sep_visibility
+= 1.0;
855 sep_visibility
+= (double)(info
.small_begin_need_separator_width
- info
.rect
.width
) / (double)(info
.small_begin_need_separator_width
- info
.small_must_have_separator_width
);
861 wxRect rect
= m_pages
.Item(0).rect
;
862 rect
.width
= m_art
->GetMetric(wxRIBBON_ART_TAB_SEPARATION_SIZE
);
863 sep_visibility
/= (double)numtabs
;
864 for(i
= 0; i
< numtabs
- 1; ++i
)
866 wxRibbonPageTabInfo
& info
= m_pages
.Item(i
);
869 rect
.x
= info
.rect
.x
+ info
.rect
.width
;
871 if(m_tab_scroll_buttons_shown
&& !tabs_rect
.Intersects(rect
))
876 dc
.DestroyClippingRegion();
877 dc
.SetClippingRegion(rect
);
878 m_art
->DrawTabSeparator(dc
, this, rect
, sep_visibility
);
881 if(m_tab_scroll_buttons_shown
)
883 if(m_tab_scroll_left_button_rect
.GetWidth() != 0)
885 dc
.DestroyClippingRegion();
886 dc
.SetClippingRegion(m_tab_scroll_left_button_rect
);
887 m_art
->DrawScrollButton(dc
, this, m_tab_scroll_left_button_rect
, wxRIBBON_SCROLL_BTN_LEFT
| m_tab_scroll_left_button_state
| wxRIBBON_SCROLL_BTN_FOR_TABS
);
889 if(m_tab_scroll_right_button_rect
.GetWidth() != 0)
891 dc
.DestroyClippingRegion();
892 dc
.SetClippingRegion(m_tab_scroll_right_button_rect
);
893 m_art
->DrawScrollButton(dc
, this, m_tab_scroll_right_button_rect
, wxRIBBON_SCROLL_BTN_RIGHT
| m_tab_scroll_right_button_state
| wxRIBBON_SCROLL_BTN_FOR_TABS
);
897 if ( m_flags
& wxRIBBON_BAR_SHOW_HELP_BUTTON
)
898 m_art
->DrawHelpButton(dc
, this, m_help_button_rect
);
899 if ( m_flags
& wxRIBBON_BAR_SHOW_TOGGLE_BUTTON
)
900 m_art
->DrawToggleButton(dc
, this, m_toggle_button_rect
, m_ribbon_state
);
904 void wxRibbonBar::OnEraseBackground(wxEraseEvent
& WXUNUSED(evt
))
906 // Background painting done in main paint handler to reduce screen flicker
909 void wxRibbonBar::DoEraseBackground(wxDC
& dc
)
911 wxRect
tabs(GetSize());
912 tabs
.height
= m_tab_height
;
913 m_art
->DrawTabCtrlBackground(dc
, this, tabs
);
916 void wxRibbonBar::OnSize(wxSizeEvent
& evt
)
918 RecalculateTabSizes();
919 if(m_current_page
!= -1)
921 RepositionPage(m_pages
.Item(m_current_page
).page
);
928 void wxRibbonBar::RepositionPage(wxRibbonPage
*page
)
932 page
->SetSizeWithScrollButtonAdjustment(0, m_tab_height
, w
, h
- m_tab_height
);
935 wxRibbonPageTabInfo
* wxRibbonBar::HitTestTabs(wxPoint position
, int* index
)
937 wxRect
tabs_rect(m_tab_margin_left
, 0, GetClientSize().GetWidth() - m_tab_margin_left
- m_tab_margin_right
, m_tab_height
);
938 if(m_tab_scroll_buttons_shown
)
940 tabs_rect
.SetX(tabs_rect
.GetX() + m_tab_scroll_left_button_rect
.GetWidth());
941 tabs_rect
.SetWidth(tabs_rect
.GetWidth() - m_tab_scroll_left_button_rect
.GetWidth() - m_tab_scroll_right_button_rect
.GetWidth());
943 if(tabs_rect
.Contains(position
))
945 size_t numtabs
= m_pages
.GetCount();
947 for(i
= 0; i
< numtabs
; ++i
)
949 wxRibbonPageTabInfo
& info
= m_pages
.Item(i
);
952 if(info
.rect
.Contains(position
))
969 void wxRibbonBar::OnMouseLeftDown(wxMouseEvent
& evt
)
971 wxRibbonPageTabInfo
*tab
= HitTestTabs(evt
.GetPosition());
975 if ( m_ribbon_state
== wxRIBBON_BAR_MINIMIZED
)
978 m_ribbon_state
= wxRIBBON_BAR_EXPANDED
;
980 else if ( (tab
== &m_pages
.Item(m_current_page
)) && (m_ribbon_state
== wxRIBBON_BAR_EXPANDED
) )
983 m_ribbon_state
= wxRIBBON_BAR_MINIMIZED
;
988 if ( m_ribbon_state
== wxRIBBON_BAR_EXPANDED
)
991 m_ribbon_state
= wxRIBBON_BAR_MINIMIZED
;
994 if(tab
&& tab
!= &m_pages
.Item(m_current_page
))
996 wxRibbonBarEvent
query(wxEVT_RIBBONBAR_PAGE_CHANGING
, GetId(), tab
->page
);
997 query
.SetEventObject(this);
998 ProcessWindowEvent(query
);
999 if(query
.IsAllowed())
1001 SetActivePage(query
.GetPage());
1003 wxRibbonBarEvent
notification(wxEVT_RIBBONBAR_PAGE_CHANGED
, GetId(), m_pages
.Item(m_current_page
).page
);
1004 notification
.SetEventObject(this);
1005 ProcessWindowEvent(notification
);
1008 else if(tab
== NULL
)
1010 if(m_tab_scroll_left_button_rect
.Contains(evt
.GetPosition()))
1012 m_tab_scroll_left_button_state
|= wxRIBBON_SCROLL_BTN_ACTIVE
| wxRIBBON_SCROLL_BTN_HOVERED
;
1015 else if(m_tab_scroll_right_button_rect
.Contains(evt
.GetPosition()))
1017 m_tab_scroll_right_button_state
|= wxRIBBON_SCROLL_BTN_ACTIVE
| wxRIBBON_SCROLL_BTN_HOVERED
;
1022 wxPoint position
= evt
.GetPosition();
1024 if(position
.x
>= 0 && position
.y
>= 0)
1026 wxSize size
= GetSize();
1027 if(position
.x
< size
.GetWidth() && position
.y
< size
.GetHeight())
1029 if(m_toggle_button_rect
.Contains(position
))
1031 bool pshown
= ArePanelsShown();
1032 ShowPanels(!pshown
);
1034 m_ribbon_state
= wxRIBBON_BAR_MINIMIZED
;
1036 m_ribbon_state
= wxRIBBON_BAR_PINNED
;
1037 wxRibbonBarEvent
event(wxEVT_RIBBONBAR_TOGGLED
, GetId());
1038 event
.SetEventObject(this);
1039 ProcessWindowEvent(event
);
1041 if ( m_help_button_rect
.Contains(position
) )
1043 wxRibbonBarEvent
event(wxEVT_RIBBONBAR_HELP_CLICK
, GetId());
1044 event
.SetEventObject(this);
1045 ProcessWindowEvent(event
);
1051 void wxRibbonBar::OnMouseLeftUp(wxMouseEvent
& WXUNUSED(evt
))
1053 if(!m_tab_scroll_buttons_shown
)
1059 if(m_tab_scroll_left_button_state
& wxRIBBON_SCROLL_BTN_ACTIVE
)
1063 else if(m_tab_scroll_right_button_state
& wxRIBBON_SCROLL_BTN_ACTIVE
)
1069 m_tab_scroll_left_button_state
&= ~wxRIBBON_SCROLL_BTN_ACTIVE
;
1070 m_tab_scroll_right_button_state
&= ~wxRIBBON_SCROLL_BTN_ACTIVE
;
1071 ScrollTabBar(amount
* 8);
1075 void wxRibbonBar::ScrollTabBar(int amount
)
1077 bool show_left
= true;
1078 bool show_right
= true;
1079 if(m_tab_scroll_amount
+ amount
<= 0)
1081 amount
= -m_tab_scroll_amount
;
1084 else if(m_tab_scroll_amount
+ amount
+ (GetClientSize().GetWidth() - m_tab_margin_left
- m_tab_margin_right
) >= m_tabs_total_width_minimum
)
1086 amount
= m_tabs_total_width_minimum
- m_tab_scroll_amount
- (GetClientSize().GetWidth() - m_tab_margin_left
- m_tab_margin_right
);
1093 m_tab_scroll_amount
+= amount
;
1094 size_t numtabs
= m_pages
.GetCount();
1096 for(i
= 0; i
< numtabs
; ++i
)
1098 wxRibbonPageTabInfo
& info
= m_pages
.Item(i
);
1101 info
.rect
.SetX(info
.rect
.GetX() - amount
);
1103 if(show_right
!= (m_tab_scroll_right_button_rect
.GetWidth() != 0) ||
1104 show_left
!= (m_tab_scroll_left_button_rect
.GetWidth() != 0))
1106 wxClientDC
temp_dc(this);
1109 m_tab_scroll_left_button_rect
.SetWidth(m_art
->GetScrollButtonMinimumSize(temp_dc
, this, wxRIBBON_SCROLL_BTN_LEFT
| wxRIBBON_SCROLL_BTN_NORMAL
| wxRIBBON_SCROLL_BTN_FOR_TABS
).GetWidth());
1113 m_tab_scroll_left_button_rect
.SetWidth(0);
1118 if(m_tab_scroll_right_button_rect
.GetWidth() == 0)
1120 m_tab_scroll_right_button_rect
.SetWidth(m_art
->GetScrollButtonMinimumSize(temp_dc
, this, wxRIBBON_SCROLL_BTN_RIGHT
| wxRIBBON_SCROLL_BTN_NORMAL
| wxRIBBON_SCROLL_BTN_FOR_TABS
).GetWidth());
1121 m_tab_scroll_right_button_rect
.SetX(m_tab_scroll_right_button_rect
.GetX() - m_tab_scroll_right_button_rect
.GetWidth());
1126 if(m_tab_scroll_right_button_rect
.GetWidth() != 0)
1128 m_tab_scroll_right_button_rect
.SetX(m_tab_scroll_right_button_rect
.GetX() + m_tab_scroll_right_button_rect
.GetWidth());
1129 m_tab_scroll_right_button_rect
.SetWidth(0);
1137 void wxRibbonBar::RefreshTabBar()
1139 wxRect
tab_rect(0, 0, GetClientSize().GetWidth(), m_tab_height
);
1140 Refresh(false, &tab_rect
);
1143 void wxRibbonBar::OnMouseMiddleDown(wxMouseEvent
& evt
)
1145 DoMouseButtonCommon(evt
, wxEVT_RIBBONBAR_TAB_MIDDLE_DOWN
);
1148 void wxRibbonBar::OnMouseMiddleUp(wxMouseEvent
& evt
)
1150 DoMouseButtonCommon(evt
, wxEVT_RIBBONBAR_TAB_MIDDLE_UP
);
1153 void wxRibbonBar::OnMouseRightDown(wxMouseEvent
& evt
)
1155 DoMouseButtonCommon(evt
, wxEVT_RIBBONBAR_TAB_RIGHT_DOWN
);
1158 void wxRibbonBar::OnMouseRightUp(wxMouseEvent
& evt
)
1160 DoMouseButtonCommon(evt
, wxEVT_RIBBONBAR_TAB_RIGHT_UP
);
1163 void wxRibbonBar::OnMouseDoubleClick(wxMouseEvent
& evt
)
1165 wxRibbonPageTabInfo
*tab
= HitTestTabs(evt
.GetPosition());
1167 if ( tab
&& tab
== &m_pages
.Item(m_current_page
) )
1169 if ( m_ribbon_state
== wxRIBBON_BAR_PINNED
)
1171 m_ribbon_state
= wxRIBBON_BAR_MINIMIZED
;
1176 m_ribbon_state
= wxRIBBON_BAR_PINNED
;
1182 void wxRibbonBar::DoMouseButtonCommon(wxMouseEvent
& evt
, wxEventType tab_event_type
)
1184 wxRibbonPageTabInfo
*tab
= HitTestTabs(evt
.GetPosition());
1187 wxRibbonBarEvent
notification(tab_event_type
, GetId(), tab
->page
);
1188 notification
.SetEventObject(this);
1189 ProcessWindowEvent(notification
);
1193 void wxRibbonBar::RecalculateMinSize()
1195 wxSize
min_size(wxDefaultCoord
, wxDefaultCoord
);
1196 size_t numtabs
= m_pages
.GetCount();
1199 min_size
= m_pages
.Item(0).page
->GetMinSize();
1202 for(i
= 1; i
< numtabs
; ++i
)
1204 wxRibbonPageTabInfo
& info
= m_pages
.Item(i
);
1207 wxSize page_min
= info
.page
->GetMinSize();
1209 min_size
.x
= wxMax(min_size
.x
, page_min
.x
);
1210 min_size
.y
= wxMax(min_size
.y
, page_min
.y
);
1213 if(min_size
.y
!= wxDefaultCoord
)
1215 // TODO: Decide on best course of action when min height is unspecified
1216 // - should we specify it to the tab minimum, or leave it unspecified?
1217 min_size
.IncBy(0, m_tab_height
);
1220 m_minWidth
= min_size
.GetWidth();
1221 m_minHeight
= m_arePanelsShown
? min_size
.GetHeight() : m_tab_height
;
1224 wxSize
wxRibbonBar::DoGetBestSize() const
1227 if(m_current_page
!= -1)
1229 best
= m_pages
.Item(m_current_page
).page
->GetBestSize();
1231 if(best
.GetHeight() == wxDefaultCoord
)
1233 best
.SetHeight(m_tab_height
);
1237 best
.IncBy(0, m_tab_height
);
1239 if(!m_arePanelsShown
)
1241 best
.SetHeight(m_tab_height
);
1246 void wxRibbonBar::HitTestRibbonButton(const wxRect
& rect
, const wxPoint
& position
, bool &hover_flag
)
1248 bool hovered
= false, toggle_button_hovered
= false;
1249 if(position
.x
>= 0 && position
.y
>= 0)
1251 wxSize size
= GetSize();
1252 if(position
.x
< size
.GetWidth() && position
.y
< size
.GetHeight())
1259 toggle_button_hovered
= rect
.Contains(position
);
1261 if ( hovered
!= m_bar_hovered
|| toggle_button_hovered
!= hover_flag
)
1263 m_bar_hovered
= hovered
;
1264 hover_flag
= toggle_button_hovered
;
1270 void wxRibbonBar::HideIfExpanded()
1272 if ( m_ribbon_state
== wxRIBBON_BAR_EXPANDED
)
1275 m_ribbon_state
= wxRIBBON_BAR_MINIMIZED
;
1280 m_ribbon_state
= wxRIBBON_BAR_PINNED
;
1284 void wxRibbonBar::OnKillFocus(wxFocusEvent
& WXUNUSED(evt
))
1289 #endif // wxUSE_RIBBON