juce_Toolbar.h

Go to the documentation of this file.

/*
  ==============================================================================
 
   This file is part of the JUCE library.
   Copyright (c) 2015 - ROLI Ltd.
 
   Permission is granted to use this software under the terms of either:
   a) the GPL v2 (or any later version)
   b) the Affero GPL v3
 
   Details of these licenses can be found at: www.gnu.org/licenses
 
   JUCE is distributed in the hope that it will be useful, but WITHOUT ANY
   WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
   A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
 
   ------------------------------------------------------------------------------
 
   To release a closed-source product which uses JUCE, commercial licenses are
   available: visit www.juce.com for more information.
 
  ==============================================================================
*/
 
#ifndef JUCE_TOOLBAR_H_INCLUDED
#define JUCE_TOOLBAR_H_INCLUDED
 
class ToolbarItemComponent;
class ToolbarItemFactory;
 
 
//==============================================================================
class JUCE_API  Toolbar   : public Component,
                            public DragAndDropContainer,
                            public DragAndDropTarget,
                            private ButtonListener  // (can't use Button::Listener due to idiotic VC2005 bug)
{
public:
    //==============================================================================
    Toolbar();
 
    ~Toolbar();
 
    //==============================================================================
    void setVertical (bool shouldBeVertical);
 
    bool isVertical() const noexcept                 { return vertical; }
 
    int getThickness() const noexcept;
 
    int getLength() const noexcept;
 
    //==============================================================================
    void clear();
 
    void addItem (ToolbarItemFactory& factory,
                  int itemId,
                  int insertIndex = -1);
 
    void removeToolbarItem (int itemIndex);
 
    ToolbarItemComponent* removeAndReturnItem (int itemIndex);
 
    int getNumItems() const noexcept;
 
    int getItemId (int itemIndex) const noexcept;
 
    ToolbarItemComponent* getItemComponent (int itemIndex) const noexcept;
 
    void addDefaultItems (ToolbarItemFactory& factoryToUse);
 
    //==============================================================================
    enum ToolbarItemStyle
    {
        iconsOnly,       
        iconsWithText,   
        textOnly         
    };
 
    ToolbarItemStyle getStyle() const noexcept               { return toolbarStyle; }
 
    void setStyle (const ToolbarItemStyle& newStyle);
 
    //==============================================================================
    enum CustomisationFlags
    {
        allowIconsOnlyChoice            = 1,    
        allowIconsWithTextChoice        = 2,    
        allowTextOnlyChoice             = 4,    
        showResetToDefaultsButton       = 8,    
        allCustomisationOptionsEnabled = (allowIconsOnlyChoice | allowIconsWithTextChoice | allowTextOnlyChoice | showResetToDefaultsButton)
    };
 
    void showCustomisationDialog (ToolbarItemFactory& factory,
                                  int optionFlags = allCustomisationOptionsEnabled);
 
    void setEditingActive (bool editingEnabled);
 
    //==============================================================================
    enum ColourIds
    {
        backgroundColourId          = 0x1003200,  
        separatorColourId           = 0x1003210,  
        buttonMouseOverBackgroundColourId = 0x1003220,  
        buttonMouseDownBackgroundColourId = 0x1003230,  
        labelTextColourId           = 0x1003240,        
        editingModeOutlineColourId  = 0x1003250   
    };
 
    //==============================================================================
    String toString() const;
 
    bool restoreFromString (ToolbarItemFactory& factoryToUse,
                            const String& savedVersion);
 
    //==============================================================================
    struct JUCE_API  LookAndFeelMethods
    {
        virtual ~LookAndFeelMethods() {}
 
        virtual void paintToolbarBackground (Graphics&, int width, int height, Toolbar&) = 0;
 
        virtual Button* createToolbarMissingItemsButton (Toolbar&) = 0;
 
        virtual void paintToolbarButtonBackground (Graphics&, int width, int height,
                                                   bool isMouseOver, bool isMouseDown,
                                                   ToolbarItemComponent&) = 0;
 
        virtual void paintToolbarButtonLabel (Graphics&, int x, int y, int width, int height,
                                              const String& text, ToolbarItemComponent&) = 0;
    };
 
    //==============================================================================
    void paint (Graphics&) override;
    void resized() override;
    void mouseDown (const MouseEvent&) override;
    bool isInterestedInDragSource (const SourceDetails&) override;
    void itemDragMove (const SourceDetails&) override;
    void itemDragExit (const SourceDetails&) override;
    void itemDropped (const SourceDetails&) override;
    void updateAllItemPositions (bool animate);
    static ToolbarItemComponent* createItem (ToolbarItemFactory&, int itemId);
    static const char* const toolbarDragDescriptor;
 
private:
    //==============================================================================
    ScopedPointer<Button> missingItemsButton;
    bool vertical, isEditingActive;
    ToolbarItemStyle toolbarStyle;
    class MissingItemsComponent;
    friend class MissingItemsComponent;
    OwnedArray<ToolbarItemComponent> items;
    class Spacer;
    class CustomisationDialog;
 
    void buttonClicked (Button*) override;
    void addItemInternal (ToolbarItemFactory& factory, int itemId, int insertIndex);
 
    ToolbarItemComponent* getNextActiveComponent (int index, int delta) const;
 
    JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (Toolbar)
};
 
 
#endif   // JUCE_TOOLBAR_H_INCLUDED