X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/955bad410e165e32aa3f8b438d3c4cace59774e9..81a887a895e89622649ff394820800e2071fe6df:/interface/wx/ribbon/buttonbar.h diff --git a/interface/wx/ribbon/buttonbar.h b/interface/wx/ribbon/buttonbar.h index dd36d7c1b4..e7e80e806a 100644 --- a/interface/wx/ribbon/buttonbar.h +++ b/interface/wx/ribbon/buttonbar.h @@ -20,19 +20,19 @@ enum wxRibbonButtonBarButtonState { /** - Button is small (the interpretation of small is dependant upon the art + Button is small (the interpretation of small is dependent upon the art provider, but it will be smaller than medium). */ wxRIBBON_BUTTONBAR_BUTTON_SMALL = 0 << 0, /** - Button is medium sized (the interpretation of medium is dependant upon + Button is medium sized (the interpretation of medium is dependent upon the art provider, but it will be between small and large). */ wxRIBBON_BUTTONBAR_BUTTON_MEDIUM = 1 << 0, /** - Button is large (the interpretation of large is dependant upon the art + Button is large (the interpretation of large is dependent upon the art provider, but it will be larger than medium). */ wxRIBBON_BUTTONBAR_BUTTON_LARGE = 2 << 0, @@ -171,7 +171,7 @@ public: const wxString& label, const wxBitmap& bitmap, const wxString& help_string, - wxRibbonButtonBarButtonKind kind = wxRIBBON_BUTTONBAR_BUTTON_NORMAL); + wxRibbonButtonKind kind = wxRIBBON_BUTTON_NORMAL); /** Add a dropdown button to the button bar (simple version). @@ -248,10 +248,135 @@ public: const wxBitmap& bitmap_small = wxNullBitmap, const wxBitmap& bitmap_disabled = wxNullBitmap, const wxBitmap& bitmap_small_disabled = wxNullBitmap, - wxRibbonButtonBarButtonKind kind = wxRIBBON_BUTTONBAR_BUTTON_NORMAL, + wxRibbonButtonKind kind = wxRIBBON_BUTTON_NORMAL, const wxString& help_string = wxEmptyString, wxObject* client_data = NULL); + /** + Inserts a button to the button bar (simple version) at the given position. + + @see AddButton() + + @since 2.9.4 + */ + virtual wxRibbonButtonBarButtonBase* InsertButton( + size_t pos, + int button_id, + const wxString& label, + const wxBitmap& bitmap, + const wxString& help_string, + wxRibbonButtonKind kind = wxRIBBON_BUTTON_NORMAL); + + /** + Inserts a dropdown button to the button bar (simple version) at the + given position. + + @see InsertButton() + @see AddDropdownButton() + @see AddButton() + + @since 2.9.4 + */ + virtual wxRibbonButtonBarButtonBase* InsertDropdownButton( + size_t pos, + int button_id, + const wxString& label, + const wxBitmap& bitmap, + const wxString& help_string = wxEmptyString); + + /** + Inserts a hybrid button to the button bar (simple version) at the given + position. + + @see InsertButton() + @see AddHybridButton() + @see AddButton() + + @since 2.9.4 + */ + virtual wxRibbonButtonBarButtonBase* InsertHybridButton( + size_t pos, + int button_id, + const wxString& label, + const wxBitmap& bitmap, + const wxString& help_string = wxEmptyString); + + /** + Inserts a toggle button to the button bar (simple version) at the given + position. + + @see InsertButton() + @see AddToggleButton() + @see AddButton() + + @since 2.9.4 + */ + virtual wxRibbonButtonBarButtonBase* InsertToggleButton( + size_t pos, + int button_id, + const wxString& label, + const wxBitmap& bitmap, + const wxString& help_string = wxEmptyString); + + /** + Insert a button to the button bar at the given position. + + @param pos + Position of the new button in the button bar. + @param button_id + ID of the new button (used for event callbacks). + @param label + Label of the new button. + @param bitmap + Large bitmap of the new button. Must be the same size as all other + large bitmaps used on the button bar. + @param bitmap_small + Small bitmap of the new button. If left as null, then a small + bitmap will be automatically generated. Must be the same size as + all other small bitmaps used on the button bar. + @param bitmap_disabled + Large bitmap of the new button when it is disabled. If left as + null, then a bitmap will be automatically generated from @a bitmap. + @param bitmap_small_disabled + Small bitmap of the new button when it is disabled. If left as + null, then a bitmap will be automatically generated from @a + bitmap_small. + @param kind + The kind of button to add. + @param help_string + The UI help string to associate with the new button. + @param client_data + Client data to associate with the new button. + + @return An opaque pointer which can be used only with other button bar + methods. + + @see InsertDropdownButton() + @see InsertHybridButton() + @see InsertToggleButton() + @see AddButton() + + @since 2.9.4 + */ + 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, + wxObject* client_data = NULL); + + /** + Returns the number of buttons in this button bar. + + @since 2.9.4 + */ + virtual size_t GetButtonCount() const; + /** Calculate button layouts and positions.