1 ///////////////////////////////////////////////////////////////////////////////
2 // Name: wx/ribbon/buttonbar.h
3 // Purpose: Ribbon control similar to a tool bar
4 // Author: Peter Cawley
8 // Copyright: (C) Peter Cawley
9 // Licence: wxWindows licence
10 ///////////////////////////////////////////////////////////////////////////////
11 #ifndef _WX_RIBBON_BUTTON_BAR_H_
12 #define _WX_RIBBON_BUTTON_BAR_H_
18 #include "wx/ribbon/art.h"
19 #include "wx/ribbon/control.h"
20 #include "wx/dynarray.h"
22 class wxRibbonButtonBarButtonBase
;
23 class wxRibbonButtonBarLayout
;
24 class wxRibbonButtonBarButtonInstance
;
26 WX_DEFINE_USER_EXPORTED_ARRAY_PTR(wxRibbonButtonBarLayout
*, wxArrayRibbonButtonBarLayout
, class WXDLLIMPEXP_RIBBON
);
27 WX_DEFINE_USER_EXPORTED_ARRAY_PTR(wxRibbonButtonBarButtonBase
*, wxArrayRibbonButtonBarButtonBase
, class WXDLLIMPEXP_RIBBON
);
29 class WXDLLIMPEXP_RIBBON wxRibbonButtonBar
: public wxRibbonControl
34 wxRibbonButtonBar(wxWindow
* parent
,
35 wxWindowID id
= wxID_ANY
,
36 const wxPoint
& pos
= wxDefaultPosition
,
37 const wxSize
& size
= wxDefaultSize
,
40 virtual ~wxRibbonButtonBar();
42 bool Create(wxWindow
* parent
,
43 wxWindowID id
= wxID_ANY
,
44 const wxPoint
& pos
= wxDefaultPosition
,
45 const wxSize
& size
= wxDefaultSize
,
48 virtual wxRibbonButtonBarButtonBase
* AddButton(
50 const wxString
& label
,
51 const wxBitmap
& bitmap
,
52 const wxString
& help_string
,
53 wxRibbonButtonKind kind
= wxRIBBON_BUTTON_NORMAL
);
54 // NB: help_string cannot be optional as that would cause the signature
55 // to be identical to the full version of AddButton when 3 arguments are
58 virtual wxRibbonButtonBarButtonBase
* AddDropdownButton(
60 const wxString
& label
,
61 const wxBitmap
& bitmap
,
62 const wxString
& help_string
= wxEmptyString
);
64 virtual wxRibbonButtonBarButtonBase
* AddHybridButton(
66 const wxString
& label
,
67 const wxBitmap
& bitmap
,
68 const wxString
& help_string
= wxEmptyString
);
70 virtual wxRibbonButtonBarButtonBase
* AddToggleButton(
72 const wxString
& label
,
73 const wxBitmap
& bitmap
,
74 const wxString
& help_string
= wxEmptyString
);
76 virtual wxRibbonButtonBarButtonBase
* AddButton(
78 const wxString
& label
,
79 const wxBitmap
& bitmap
,
80 const wxBitmap
& bitmap_small
= wxNullBitmap
,
81 const wxBitmap
& bitmap_disabled
= wxNullBitmap
,
82 const wxBitmap
& bitmap_small_disabled
= wxNullBitmap
,
83 wxRibbonButtonKind kind
= wxRIBBON_BUTTON_NORMAL
,
84 const wxString
& help_string
= wxEmptyString
,
85 wxObject
* client_data
= NULL
);
87 virtual bool Realize();
88 virtual void ClearButtons();
89 virtual bool DeleteButton(int button_id
);
90 virtual void EnableButton(int button_id
, bool enable
= true);
91 virtual void ToggleButton(int button_id
, bool checked
);
93 virtual void SetArtProvider(wxRibbonArtProvider
* art
);
94 virtual bool IsSizingContinuous() const;
96 virtual wxSize
GetMinSize() const;
98 friend class wxRibbonButtonBarEvent
;
99 virtual wxSize
DoGetBestSize() const;
100 wxBorder
GetDefaultBorder() const { return wxBORDER_NONE
; }
102 void OnEraseBackground(wxEraseEvent
& evt
);
103 void OnPaint(wxPaintEvent
& evt
);
104 void OnSize(wxSizeEvent
& evt
);
105 void OnMouseMove(wxMouseEvent
& evt
);
106 void OnMouseEnter(wxMouseEvent
& evt
);
107 void OnMouseLeave(wxMouseEvent
& evt
);
108 void OnMouseDown(wxMouseEvent
& evt
);
109 void OnMouseUp(wxMouseEvent
& evt
);
111 virtual wxSize
DoGetNextSmallerSize(wxOrientation direction
,
112 wxSize relative_to
) const;
113 virtual wxSize
DoGetNextLargerSize(wxOrientation direction
,
114 wxSize relative_to
) const;
116 void CommonInit(long style
);
118 bool TryCollapseLayout(wxRibbonButtonBarLayout
* original
, size_t first_btn
, size_t* last_button
);
119 static wxBitmap
MakeResizedBitmap(const wxBitmap
& original
, wxSize size
);
120 static wxBitmap
MakeDisabledBitmap(const wxBitmap
& original
);
121 void FetchButtonSizeInfo(wxRibbonButtonBarButtonBase
* button
,
122 wxRibbonButtonBarButtonState size
, wxDC
& dc
);
123 virtual void UpdateWindowUI(long flags
);
125 wxArrayRibbonButtonBarLayout m_layouts
;
126 wxArrayRibbonButtonBarButtonBase m_buttons
;
127 wxRibbonButtonBarButtonInstance
* m_hovered_button
;
128 wxRibbonButtonBarButtonInstance
* m_active_button
;
130 wxPoint m_layout_offset
;
131 wxSize m_bitmap_size_large
;
132 wxSize m_bitmap_size_small
;
133 int m_current_layout
;
134 bool m_layouts_valid
;
135 bool m_lock_active_state
;
138 DECLARE_CLASS(wxRibbonButtonBar
)
139 DECLARE_EVENT_TABLE()
143 class WXDLLIMPEXP_RIBBON wxRibbonButtonBarEvent
: public wxCommandEvent
146 wxRibbonButtonBarEvent(wxEventType command_type
= wxEVT_NULL
,
148 wxRibbonButtonBar
* bar
= NULL
)
149 : wxCommandEvent(command_type
, win_id
)
154 wxRibbonButtonBarEvent(const wxRibbonButtonBarEvent
& e
) : wxCommandEvent(e
)
159 wxEvent
*Clone() const { return new wxRibbonButtonBarEvent(*this); }
161 wxRibbonButtonBar
* GetBar() {return m_bar
;}
162 void SetBar(wxRibbonButtonBar
* bar
) {m_bar
= bar
;}
163 bool PopupMenu(wxMenu
* menu
);
166 wxRibbonButtonBar
* m_bar
;
170 DECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxRibbonButtonBarEvent
)
176 wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_RIBBON
, wxEVT_COMMAND_RIBBONBUTTON_CLICKED
, wxRibbonButtonBarEvent
);
177 wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_RIBBON
, wxEVT_COMMAND_RIBBONBUTTON_DROPDOWN_CLICKED
, wxRibbonButtonBarEvent
);
179 typedef void (wxEvtHandler
::*wxRibbonButtonBarEventFunction
)(wxRibbonButtonBarEvent
&);
181 #define wxRibbonButtonBarEventHandler(func) \
182 wxEVENT_HANDLER_CAST(wxRibbonButtonBarEventFunction, func)
184 #define EVT_RIBBONBUTTONBAR_CLICKED(winid, fn) \
185 wx__DECLARE_EVT1(wxEVT_COMMAND_RIBBONBUTTON_CLICKED, winid, wxRibbonButtonBarEventHandler(fn))
186 #define EVT_RIBBONBUTTONBAR_DROPDOWN_CLICKED(winid, fn) \
187 wx__DECLARE_EVT1(wxEVT_COMMAND_RIBBONBUTTON_DROPDOWN_CLICKED, winid, wxRibbonButtonBarEventHandler(fn))
190 // wxpython/swig event work
191 %constant wxEventType wxEVT_COMMAND_RIBBONBUTTON_CLICKED
;
192 %constant wxEventType wxEVT_COMMAND_RIBBONBUTTON_DROPDOWN_CLICKED
;
195 EVT_RIBBONBUTTONBAR_CLICKED
= wx
.PyEventBinder( wxEVT_COMMAND_RIBBONBUTTON_CLICKED
, 1 )
196 EVT_RIBBONBUTTONBAR_DROPDOWN_CLICKED
= wx
.PyEventBinder( wxEVT_COMMAND_RIBBONBUTTON_DROPDOWN_CLICKED
, 1 )
200 #endif // wxUSE_RIBBON
202 #endif // _WX_RIBBON_BUTTON_BAR_H_