juce_Slider.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_SLIDER_H_INCLUDED
#define JUCE_SLIDER_H_INCLUDED
 
 
//==============================================================================
class JUCE_API  Slider  : public Component,
                          public SettableTooltipClient
{
public:
    //==============================================================================
    enum SliderStyle
    {
        LinearHorizontal,               
        LinearVertical,                 
        LinearBar,                      
        LinearBarVertical,
        Rotary,                         
        RotaryHorizontalDrag,           
        RotaryVerticalDrag,             
        RotaryHorizontalVerticalDrag,   
        IncDecButtons,                  
        TwoValueHorizontal,             
        TwoValueVertical,               
        ThreeValueHorizontal,           
        ThreeValueVertical,             
    };
 
    enum TextEntryBoxPosition
    {
        NoTextBox,              
        TextBoxLeft,            
        TextBoxRight,           
        TextBoxAbove,           
        TextBoxBelow            
    };
 
    enum DragMode
    {
        notDragging,            
        absoluteDrag,           
        velocityDrag            
    };
 
    //==============================================================================
    Slider();
 
    explicit Slider (const String& componentName);
 
    Slider (SliderStyle style, TextEntryBoxPosition textBoxPosition);
 
    ~Slider();
 
    //==============================================================================
    void setSliderStyle (SliderStyle newStyle);
 
    SliderStyle getSliderStyle() const noexcept;
 
    //==============================================================================
    void setRotaryParameters (float startAngleRadians,
                              float endAngleRadians,
                              bool stopAtEnd);
 
    void setMouseDragSensitivity (int distanceForFullScaleDrag);
 
    int getMouseDragSensitivity() const noexcept;
 
    //==============================================================================
    void setVelocityBasedMode (bool isVelocityBased);
 
    bool getVelocityBasedMode() const noexcept;
 
    void setVelocityModeParameters (double sensitivity = 1.0,
                                    int threshold = 1,
                                    double offset = 0.0,
                                    bool userCanPressKeyToSwapMode = true);
 
    double getVelocitySensitivity() const noexcept;
 
    int getVelocityThreshold() const noexcept;
 
    double getVelocityOffset() const noexcept;
 
    bool getVelocityModeIsSwappable() const noexcept;
 
    //==============================================================================
    void setSkewFactor (double factor);
 
    void setSkewFactorFromMidPoint (double sliderValueToShowAtMidPoint);
 
    double getSkewFactor() const noexcept;
 
    //==============================================================================
    enum IncDecButtonMode
    {
        incDecButtonsNotDraggable,
        incDecButtonsDraggable_AutoDirection,
        incDecButtonsDraggable_Horizontal,
        incDecButtonsDraggable_Vertical
    };
 
    void setIncDecButtonsMode (IncDecButtonMode mode);
 
    //==============================================================================
    void setTextBoxStyle (TextEntryBoxPosition newPosition,
                          bool isReadOnly,
                          int textEntryBoxWidth,
                          int textEntryBoxHeight);
 
    TextEntryBoxPosition getTextBoxPosition() const noexcept;
 
    int getTextBoxWidth() const noexcept;
 
    int getTextBoxHeight() const noexcept;
 
    void setTextBoxIsEditable (bool shouldBeEditable);
 
    bool isTextBoxEditable() const noexcept;
 
    void showTextBox();
 
    void hideTextBox (bool discardCurrentEditorContents);
 
 
    //==============================================================================
    void setValue (double newValue, NotificationType notification = sendNotificationAsync);
 
    double getValue() const;
 
    Value& getValueObject() noexcept;
 
    //==============================================================================
    void setRange (double newMinimum,
                   double newMaximum,
                   double newInterval = 0);
 
    double getMaximum() const noexcept;
 
    double getMinimum() const noexcept;
 
    double getInterval() const noexcept;
 
    //==============================================================================
    double getMinValue() const;
 
    Value& getMinValueObject() noexcept;
 
    void setMinValue (double newValue,
                      NotificationType notification = sendNotificationAsync,
                      bool allowNudgingOfOtherValues = false);
 
    double getMaxValue() const;
 
    Value& getMaxValueObject() noexcept;
 
    void setMaxValue (double newValue,
                      NotificationType notification = sendNotificationAsync,
                      bool allowNudgingOfOtherValues = false);
 
    void setMinAndMaxValues (double newMinValue, double newMaxValue,
                             NotificationType notification = sendNotificationAsync);
 
    //==============================================================================
    class JUCE_API  Listener
    {
    public:
        //==============================================================================
        virtual ~Listener() {}
 
        //==============================================================================
        virtual void sliderValueChanged (Slider* slider) = 0;
 
        //==============================================================================
        virtual void sliderDragStarted (Slider*) {}
 
        virtual void sliderDragEnded (Slider*) {}
    };
 
    void addListener (Listener* listener);
 
    void removeListener (Listener* listener);
 
    //==============================================================================
    void setDoubleClickReturnValue (bool shouldDoubleClickBeEnabled,
                                    double valueToSetOnDoubleClick);
 
    double getDoubleClickReturnValue() const noexcept;
 
    bool isDoubleClickReturnEnabled() const noexcept;
 
    //==============================================================================
    void setChangeNotificationOnlyOnRelease (bool onlyNotifyOnRelease);
 
    void setSliderSnapsToMousePosition (bool shouldSnapToMouse);
 
    bool getSliderSnapsToMousePosition() const noexcept;
 
    void setPopupDisplayEnabled (bool isEnabled, Component* parentComponentToUse);
 
    Component* getCurrentPopupDisplay() const noexcept;
 
    void setPopupMenuEnabled (bool menuEnabled);
 
    void setScrollWheelEnabled (bool enabled);
 
    int getThumbBeingDragged() const noexcept;
 
    //==============================================================================
    virtual void startedDragging();
 
    virtual void stoppedDragging();
 
    virtual void valueChanged();
 
    //==============================================================================
    virtual double getValueFromText (const String& text);
 
    virtual String getTextFromValue (double value);
 
    void setTextValueSuffix (const String& suffix);
 
    String getTextValueSuffix() const;
 
    int getNumDecimalPlacesToDisplay() const noexcept;
 
    //==============================================================================
    virtual double proportionOfLengthToValue (double proportion);
 
    virtual double valueToProportionOfLength (double value);
 
    float getPositionOfValue (double value);
 
    //==============================================================================
    virtual double snapValue (double attemptedValue, DragMode dragMode);
 
 
    //==============================================================================
    void updateText();
 
    bool isHorizontal() const noexcept;
    bool isVertical() const noexcept;
    bool isRotary() const noexcept;
    bool isBar() const noexcept;
 
    //==============================================================================
    enum ColourIds
    {
        backgroundColourId          = 0x1001200,  
        thumbColourId               = 0x1001300,  
        trackColourId               = 0x1001310,  
        rotarySliderFillColourId    = 0x1001311,  
        rotarySliderOutlineColourId = 0x1001312,  
        textBoxTextColourId         = 0x1001400,  
        textBoxBackgroundColourId   = 0x1001500,  
        textBoxHighlightColourId    = 0x1001600,  
        textBoxOutlineColourId      = 0x1001700   
    };
 
    //==============================================================================
    struct SliderLayout
    {
        Rectangle<int> sliderBounds;
        Rectangle<int> textBoxBounds;
    };
 
    //==============================================================================
    struct JUCE_API  LookAndFeelMethods
    {
        virtual ~LookAndFeelMethods() {}
 
        //==============================================================================
        virtual void drawLinearSlider (Graphics&,
                                       int x, int y, int width, int height,
                                       float sliderPos,
                                       float minSliderPos,
                                       float maxSliderPos,
                                       const Slider::SliderStyle,
                                       Slider&) = 0;
 
        virtual void drawLinearSliderBackground (Graphics&,
                                                 int x, int y, int width, int height,
                                                 float sliderPos,
                                                 float minSliderPos,
                                                 float maxSliderPos,
                                                 const Slider::SliderStyle style,
                                                 Slider&) = 0;
 
        virtual void drawLinearSliderThumb (Graphics&,
                                            int x, int y, int width, int height,
                                            float sliderPos,
                                            float minSliderPos,
                                            float maxSliderPos,
                                            const Slider::SliderStyle,
                                            Slider&) = 0;
 
        virtual int getSliderThumbRadius (Slider&) = 0;
 
        virtual void drawRotarySlider (Graphics&,
                                       int x, int y, int width, int height,
                                       float sliderPosProportional,
                                       float rotaryStartAngle,
                                       float rotaryEndAngle,
                                       Slider&) = 0;
 
        virtual Button* createSliderButton (Slider&, bool isIncrement) = 0;
        virtual Label* createSliderTextBox (Slider&) = 0;
 
        virtual ImageEffectFilter* getSliderEffect (Slider&) = 0;
 
        virtual Font getSliderPopupFont (Slider&) = 0;
        virtual int getSliderPopupPlacement (Slider&) = 0;
 
        virtual SliderLayout getSliderLayout (Slider&) = 0;
 
       #if JUCE_CATCH_DEPRECATED_CODE_MISUSE
        // These methods' parameters have changed: see the new method signatures.
        virtual void createSliderButton (bool) {}
        virtual void getSliderEffect() {}
        virtual void getSliderPopupFont() {}
        virtual void getSliderPopupPlacement() {}
       #endif
    };
 
    //==============================================================================
    void paint (Graphics&) override;
    void resized() override;
    void mouseDown (const MouseEvent&) override;
    void mouseUp (const MouseEvent&) override;
    void mouseDrag (const MouseEvent&) override;
    void mouseDoubleClick (const MouseEvent&) override;
    void mouseWheelMove (const MouseEvent&, const MouseWheelDetails&) override;
    void modifierKeysChanged (const ModifierKeys&) override;
    void lookAndFeelChanged() override;
    void enablementChanged() override;
    void focusOfChildComponentChanged (FocusChangeType) override;
    void colourChanged() override;
 
private:
    //==============================================================================
    JUCE_PUBLIC_IN_DLL_BUILD (class Pimpl)
    friend class Pimpl;
    friend struct ContainerDeletePolicy<Pimpl>;
    ScopedPointer<Pimpl> pimpl;
 
    void init (SliderStyle, TextEntryBoxPosition);
 
   #if JUCE_CATCH_DEPRECATED_CODE_MISUSE
    // These methods' bool parameters have changed: see the new method signature.
    JUCE_DEPRECATED (void setValue (double, bool));
    JUCE_DEPRECATED (void setValue (double, bool, bool));
    JUCE_DEPRECATED (void setMinValue (double, bool, bool, bool));
    JUCE_DEPRECATED (void setMinValue (double, bool, bool));
    JUCE_DEPRECATED (void setMinValue (double, bool));
    JUCE_DEPRECATED (void setMaxValue (double, bool, bool, bool));
    JUCE_DEPRECATED (void setMaxValue (double, bool, bool));
    JUCE_DEPRECATED (void setMaxValue (double, bool));
    JUCE_DEPRECATED (void setMinAndMaxValues (double, double, bool, bool));
    JUCE_DEPRECATED (void setMinAndMaxValues (double, double, bool));
    virtual void snapValue (double, bool) {}
   #endif
 
    JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (Slider)
};
 
typedef Slider::Listener SliderListener;
 
#endif   // JUCE_SLIDER_H_INCLUDED