285 lines
11 KiB
C++
285 lines
11 KiB
C++
///////////////////////////////////////////////////////////////////////////////
|
|
// Name: wx/ribbon/buttonbar.h
|
|
// Purpose: Ribbon control similar to a tool bar
|
|
// Author: Peter Cawley
|
|
// Modified by:
|
|
// Created: 2009-07-01
|
|
// Copyright: (C) Peter Cawley
|
|
// Licence: wxWindows licence
|
|
///////////////////////////////////////////////////////////////////////////////
|
|
#ifndef _WX_RIBBON_BUTTON_BAR_H_
|
|
#define _WX_RIBBON_BUTTON_BAR_H_
|
|
|
|
#include "wx/defs.h"
|
|
|
|
#if wxUSE_RIBBON
|
|
|
|
#include "wx/ribbon/art.h"
|
|
#include "wx/ribbon/control.h"
|
|
#include "wx/dynarray.h"
|
|
|
|
class wxRibbonButtonBarButtonBase;
|
|
class wxRibbonButtonBarLayout;
|
|
class wxRibbonButtonBarButtonInstance;
|
|
|
|
WX_DEFINE_USER_EXPORTED_ARRAY_PTR(wxRibbonButtonBarLayout*, wxArrayRibbonButtonBarLayout, class WXDLLIMPEXP_RIBBON);
|
|
WX_DEFINE_USER_EXPORTED_ARRAY_PTR(wxRibbonButtonBarButtonBase*, wxArrayRibbonButtonBarButtonBase, class WXDLLIMPEXP_RIBBON);
|
|
|
|
class WXDLLIMPEXP_RIBBON wxRibbonButtonBar : public wxRibbonControl
|
|
{
|
|
public:
|
|
wxRibbonButtonBar();
|
|
|
|
wxRibbonButtonBar(wxWindow* parent,
|
|
wxWindowID id = wxID_ANY,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long style = 0);
|
|
|
|
virtual ~wxRibbonButtonBar();
|
|
|
|
bool Create(wxWindow* parent,
|
|
wxWindowID id = wxID_ANY,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long style = 0);
|
|
|
|
virtual wxRibbonButtonBarButtonBase* AddButton(
|
|
int button_id,
|
|
const wxString& label,
|
|
const wxBitmap& bitmap,
|
|
const wxString& help_string,
|
|
wxRibbonButtonKind kind = wxRIBBON_BUTTON_NORMAL);
|
|
// NB: help_string cannot be optional as that would cause the signature
|
|
// to be identical to the full version of AddButton when 3 arguments are
|
|
// given.
|
|
|
|
virtual wxRibbonButtonBarButtonBase* AddDropdownButton(
|
|
int button_id,
|
|
const wxString& label,
|
|
const wxBitmap& bitmap,
|
|
const wxString& help_string = wxEmptyString);
|
|
|
|
virtual wxRibbonButtonBarButtonBase* AddHybridButton(
|
|
int button_id,
|
|
const wxString& label,
|
|
const wxBitmap& bitmap,
|
|
const wxString& help_string = wxEmptyString);
|
|
|
|
virtual wxRibbonButtonBarButtonBase* AddToggleButton(
|
|
int button_id,
|
|
const wxString& label,
|
|
const wxBitmap& bitmap,
|
|
const wxString& help_string = wxEmptyString);
|
|
|
|
virtual wxRibbonButtonBarButtonBase* AddButton(
|
|
int button_id,
|
|
const wxString& label,
|
|
const wxBitmap& bitmap,
|
|
const wxBitmap& bitmap_small = wxNullBitmap,
|
|
const wxBitmap& bitmap_disabled = wxNullBitmap,
|
|
const wxBitmap& bitmap_small_disabled = wxNullBitmap,
|
|
wxRibbonButtonKind kind = wxRIBBON_BUTTON_NORMAL,
|
|
const wxString& help_string = wxEmptyString);
|
|
|
|
virtual wxRibbonButtonBarButtonBase* InsertButton(
|
|
size_t pos,
|
|
int button_id,
|
|
const wxString& label,
|
|
const wxBitmap& bitmap,
|
|
const wxString& help_string,
|
|
wxRibbonButtonKind kind = wxRIBBON_BUTTON_NORMAL);
|
|
|
|
virtual wxRibbonButtonBarButtonBase* InsertDropdownButton(
|
|
size_t pos,
|
|
int button_id,
|
|
const wxString& label,
|
|
const wxBitmap& bitmap,
|
|
const wxString& help_string = wxEmptyString);
|
|
|
|
virtual wxRibbonButtonBarButtonBase* InsertHybridButton(
|
|
size_t pos,
|
|
int button_id,
|
|
const wxString& label,
|
|
const wxBitmap& bitmap,
|
|
const wxString& help_string = wxEmptyString);
|
|
|
|
virtual wxRibbonButtonBarButtonBase* InsertToggleButton(
|
|
size_t pos,
|
|
int button_id,
|
|
const wxString& label,
|
|
const wxBitmap& bitmap,
|
|
const wxString& help_string = wxEmptyString);
|
|
|
|
virtual wxRibbonButtonBarButtonBase* InsertButton(
|
|
size_t pos,
|
|
int button_id,
|
|
const wxString& label,
|
|
const wxBitmap& bitmap,
|
|
const wxBitmap& bitmap_small = wxNullBitmap,
|
|
const wxBitmap& bitmap_disabled = wxNullBitmap,
|
|
const wxBitmap& bitmap_small_disabled = wxNullBitmap,
|
|
wxRibbonButtonKind kind = wxRIBBON_BUTTON_NORMAL,
|
|
const wxString& help_string = wxEmptyString);
|
|
|
|
void SetItemClientObject(wxRibbonButtonBarButtonBase* item, wxClientData* data);
|
|
wxClientData* GetItemClientObject(const wxRibbonButtonBarButtonBase* item) const;
|
|
void SetItemClientData(wxRibbonButtonBarButtonBase* item, void* data);
|
|
void* GetItemClientData(const wxRibbonButtonBarButtonBase* item) const;
|
|
|
|
virtual size_t GetButtonCount() const;
|
|
virtual wxRibbonButtonBarButtonBase *GetItem(size_t n) const;
|
|
virtual wxRibbonButtonBarButtonBase *GetItemById(int id) const;
|
|
virtual int GetItemId(wxRibbonButtonBarButtonBase *button) const;
|
|
|
|
|
|
virtual bool Realize() wxOVERRIDE;
|
|
virtual void ClearButtons();
|
|
virtual bool DeleteButton(int button_id);
|
|
virtual void EnableButton(int button_id, bool enable = true);
|
|
virtual void ToggleButton(int button_id, bool checked);
|
|
|
|
virtual void SetButtonIcon(
|
|
int button_id,
|
|
const wxBitmap& bitmap,
|
|
const wxBitmap& bitmap_small = wxNullBitmap,
|
|
const wxBitmap& bitmap_disabled = wxNullBitmap,
|
|
const wxBitmap& bitmap_small_disabled = wxNullBitmap);
|
|
|
|
virtual void SetButtonText(int button_id, const wxString& label);
|
|
virtual void SetButtonTextMinWidth(int button_id,
|
|
int min_width_medium, int min_width_large);
|
|
virtual void SetButtonTextMinWidth(int button_id, const wxString& label);
|
|
virtual void SetButtonMinSizeClass(int button_id,
|
|
wxRibbonButtonBarButtonState min_size_class);
|
|
virtual void SetButtonMaxSizeClass(int button_id,
|
|
wxRibbonButtonBarButtonState max_size_class);
|
|
|
|
virtual wxRibbonButtonBarButtonBase *GetActiveItem() const;
|
|
virtual wxRibbonButtonBarButtonBase *GetHoveredItem() const;
|
|
|
|
virtual void SetArtProvider(wxRibbonArtProvider* art) wxOVERRIDE;
|
|
virtual bool IsSizingContinuous() const wxOVERRIDE;
|
|
|
|
virtual wxSize GetMinSize() const wxOVERRIDE;
|
|
|
|
void SetShowToolTipsForDisabled(bool show);
|
|
bool GetShowToolTipsForDisabled() const;
|
|
|
|
protected:
|
|
friend class wxRibbonButtonBarEvent;
|
|
virtual wxSize DoGetBestSize() const wxOVERRIDE;
|
|
wxBorder GetDefaultBorder() const wxOVERRIDE { return wxBORDER_NONE; }
|
|
|
|
void OnEraseBackground(wxEraseEvent& evt);
|
|
void OnPaint(wxPaintEvent& evt);
|
|
void OnSize(wxSizeEvent& evt);
|
|
void OnMouseMove(wxMouseEvent& evt);
|
|
void OnMouseEnter(wxMouseEvent& evt);
|
|
void OnMouseLeave(wxMouseEvent& evt);
|
|
void OnMouseDown(wxMouseEvent& evt);
|
|
void OnMouseUp(wxMouseEvent& evt);
|
|
|
|
virtual wxSize DoGetNextSmallerSize(wxOrientation direction,
|
|
wxSize relative_to) const wxOVERRIDE;
|
|
virtual wxSize DoGetNextLargerSize(wxOrientation direction,
|
|
wxSize relative_to) const wxOVERRIDE;
|
|
|
|
void CommonInit(long style);
|
|
void MakeLayouts();
|
|
void TryCollapseLayout(wxRibbonButtonBarLayout* original,
|
|
size_t first_btn, size_t* last_button,
|
|
wxRibbonButtonBarButtonState target_size);
|
|
void MakeBitmaps(wxRibbonButtonBarButtonBase* base,
|
|
const wxBitmap& bitmap_large,
|
|
const wxBitmap& bitmap_large_disabled,
|
|
const wxBitmap& bitmap_small,
|
|
const wxBitmap& bitmap_small_disabled);
|
|
static wxBitmap MakeResizedBitmap(const wxBitmap& original, wxSize size);
|
|
static wxBitmap MakeDisabledBitmap(const wxBitmap& original);
|
|
void FetchButtonSizeInfo(wxRibbonButtonBarButtonBase* button,
|
|
wxRibbonButtonBarButtonState size, wxDC& dc);
|
|
virtual void UpdateWindowUI(long flags) wxOVERRIDE;
|
|
|
|
wxArrayRibbonButtonBarLayout m_layouts;
|
|
wxArrayRibbonButtonBarButtonBase m_buttons;
|
|
wxRibbonButtonBarButtonInstance* m_hovered_button;
|
|
wxRibbonButtonBarButtonInstance* m_active_button;
|
|
|
|
wxPoint m_layout_offset;
|
|
wxSize m_bitmap_size_large;
|
|
wxSize m_bitmap_size_small;
|
|
int m_current_layout;
|
|
bool m_layouts_valid;
|
|
bool m_lock_active_state;
|
|
bool m_show_tooltips_for_disabled;
|
|
|
|
#ifndef SWIG
|
|
wxDECLARE_CLASS(wxRibbonButtonBar);
|
|
wxDECLARE_EVENT_TABLE();
|
|
#endif
|
|
};
|
|
|
|
class WXDLLIMPEXP_RIBBON wxRibbonButtonBarEvent : public wxCommandEvent
|
|
{
|
|
public:
|
|
wxRibbonButtonBarEvent(wxEventType command_type = wxEVT_NULL,
|
|
int win_id = 0,
|
|
wxRibbonButtonBar* bar = NULL,
|
|
wxRibbonButtonBarButtonBase* button = NULL)
|
|
: wxCommandEvent(command_type, win_id)
|
|
, m_bar(bar), m_button(button)
|
|
{
|
|
}
|
|
wxEvent *Clone() const wxOVERRIDE { return new wxRibbonButtonBarEvent(*this); }
|
|
|
|
wxRibbonButtonBar* GetBar() {return m_bar;}
|
|
wxRibbonButtonBarButtonBase *GetButton() { return m_button; }
|
|
void SetBar(wxRibbonButtonBar* bar) {m_bar = bar;}
|
|
void SetButton(wxRibbonButtonBarButtonBase* button) { m_button = button; }
|
|
bool PopupMenu(wxMenu* menu);
|
|
|
|
protected:
|
|
wxRibbonButtonBar* m_bar;
|
|
wxRibbonButtonBarButtonBase *m_button;
|
|
|
|
#ifndef SWIG
|
|
private:
|
|
wxDECLARE_DYNAMIC_CLASS_NO_ASSIGN(wxRibbonButtonBarEvent);
|
|
#endif
|
|
};
|
|
|
|
#ifndef SWIG
|
|
|
|
wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_RIBBON, wxEVT_RIBBONBUTTONBAR_CLICKED, wxRibbonButtonBarEvent);
|
|
wxDECLARE_EXPORTED_EVENT(WXDLLIMPEXP_RIBBON, wxEVT_RIBBONBUTTONBAR_DROPDOWN_CLICKED, wxRibbonButtonBarEvent);
|
|
|
|
typedef void (wxEvtHandler::*wxRibbonButtonBarEventFunction)(wxRibbonButtonBarEvent&);
|
|
|
|
#define wxRibbonButtonBarEventHandler(func) \
|
|
wxEVENT_HANDLER_CAST(wxRibbonButtonBarEventFunction, func)
|
|
|
|
#define EVT_RIBBONBUTTONBAR_CLICKED(winid, fn) \
|
|
wx__DECLARE_EVT1(wxEVT_RIBBONBUTTONBAR_CLICKED, winid, wxRibbonButtonBarEventHandler(fn))
|
|
#define EVT_RIBBONBUTTONBAR_DROPDOWN_CLICKED(winid, fn) \
|
|
wx__DECLARE_EVT1(wxEVT_RIBBONBUTTONBAR_DROPDOWN_CLICKED, winid, wxRibbonButtonBarEventHandler(fn))
|
|
#else
|
|
|
|
// wxpython/swig event work
|
|
%constant wxEventType wxEVT_RIBBONBUTTONBAR_CLICKED;
|
|
%constant wxEventType wxEVT_RIBBONBUTTONBAR_DROPDOWN_CLICKED;
|
|
|
|
%pythoncode {
|
|
EVT_RIBBONBUTTONBAR_CLICKED = wx.PyEventBinder( wxEVT_RIBBONBUTTONBAR_CLICKED, 1 )
|
|
EVT_RIBBONBUTTONBAR_DROPDOWN_CLICKED = wx.PyEventBinder( wxEVT_RIBBONBUTTONBAR_DROPDOWN_CLICKED, 1 )
|
|
}
|
|
#endif
|
|
|
|
// old wxEVT_COMMAND_* constants
|
|
#define wxEVT_COMMAND_RIBBONBUTTON_CLICKED wxEVT_RIBBONBUTTONBAR_CLICKED
|
|
#define wxEVT_COMMAND_RIBBONBUTTON_DROPDOWN_CLICKED wxEVT_RIBBONBUTTONBAR_DROPDOWN_CLICKED
|
|
|
|
#endif // wxUSE_RIBBON
|
|
|
|
#endif // _WX_RIBBON_BUTTON_BAR_H_
|