juce_LookAndFeel.h

Go to the documentation of this file.

/*
  ==============================================================================
 
   This file is part of the JUCE library.
   Copyright (c) 2022 - Raw Material Software Limited
 
   JUCE is an open source library subject to commercial or open-source
   licensing.
 
   By using JUCE, you agree to the terms of both the JUCE 7 End-User License
   Agreement and JUCE Privacy Policy.
 
   End User License Agreement: www.juce.com/juce-7-licence
   Privacy Policy: www.juce.com/juce-privacy-policy
 
   Or: You may also use this code under the terms of the GPL v3 (see
   www.gnu.org/licenses).
 
   JUCE IS PROVIDED "AS IS" WITHOUT ANY WARRANTY, AND ALL WARRANTIES, WHETHER
   EXPRESSED OR IMPLIED, INCLUDING MERCHANTABILITY AND FITNESS FOR PURPOSE, ARE
   DISCLAIMED.
 
  ==============================================================================
*/
 
namespace juce
{
 
//==============================================================================
struct JUCE_API  ExtraLookAndFeelBaseClasses
{
    //==============================================================================
    struct JUCE_API  LassoComponentMethods
    {
        virtual ~LassoComponentMethods() = default;
 
        virtual void drawLasso (Graphics&, Component& lassoComp) = 0;
    };
 
    //==============================================================================
    struct JUCE_API  KeyMappingEditorComponentMethods
    {
        virtual ~KeyMappingEditorComponentMethods() = default;
 
        virtual void drawKeymapChangeButton (Graphics&, int width, int height, Button&, const String& keyDescription) = 0;
    };
 
    //==============================================================================
    struct JUCE_API  AudioDeviceSelectorComponentMethods
    {
        virtual ~AudioDeviceSelectorComponentMethods() = default;
 
        virtual void drawLevelMeter (Graphics&, int width, int height, float level) = 0;
    };
};
 
 
//==============================================================================
class JUCE_API  LookAndFeel   : public ScrollBar::LookAndFeelMethods,
                                public Button::LookAndFeelMethods,
                                public ImageButton::LookAndFeelMethods,
                                public TextEditor::LookAndFeelMethods,
                                public FileBrowserComponent::LookAndFeelMethods,
                                public TreeView::LookAndFeelMethods,
                                public BubbleComponent::LookAndFeelMethods,
                                public AlertWindow::LookAndFeelMethods,
                                public PopupMenu::LookAndFeelMethods,
                                public ComboBox::LookAndFeelMethods,
                                public Label::LookAndFeelMethods,
                                public Slider::LookAndFeelMethods,
                                public ResizableWindow::LookAndFeelMethods,
                                public DocumentWindow::LookAndFeelMethods,
                                public TooltipWindow::LookAndFeelMethods,
                                public TabbedButtonBar::LookAndFeelMethods,
                                public PropertyComponent::LookAndFeelMethods,
                                public FilenameComponent::LookAndFeelMethods,
                                public GroupComponent::LookAndFeelMethods,
                                public TableHeaderComponent::LookAndFeelMethods,
                                public CallOutBox::LookAndFeelMethods,
                                public Toolbar::LookAndFeelMethods,
                                public ConcertinaPanel::LookAndFeelMethods,
                                public ProgressBar::LookAndFeelMethods,
                                public StretchableLayoutResizerBar::LookAndFeelMethods,
                                public ExtraLookAndFeelBaseClasses::KeyMappingEditorComponentMethods,
                                public ExtraLookAndFeelBaseClasses::AudioDeviceSelectorComponentMethods,
                                public ExtraLookAndFeelBaseClasses::LassoComponentMethods,
                                public SidePanel::LookAndFeelMethods
{
public:
    //==============================================================================
    LookAndFeel();

    ~LookAndFeel() override;
 
    //==============================================================================
    static LookAndFeel& getDefaultLookAndFeel() noexcept;

    static void setDefaultLookAndFeel (LookAndFeel* newDefaultLookAndFeel) noexcept;
 
    //==============================================================================
    Colour findColour (int colourId) const noexcept;

    void setColour (int colourId, Colour colour) noexcept;

    bool isColourSpecified (int colourId) const noexcept;
 
    //==============================================================================
    virtual Typeface::Ptr getTypefaceForFont (const Font&);

    void setDefaultSansSerifTypeface (Typeface::Ptr newDefaultTypeface);

    void setDefaultSansSerifTypefaceName (const String& newName);
 
    //==============================================================================
    void setUsingNativeAlertWindows (bool shouldUseNativeAlerts);

    bool isUsingNativeAlertWindows();
 
    //==============================================================================
    virtual void drawSpinningWaitAnimation (Graphics&, const Colour& colour,
                                            int x, int y, int w, int h) = 0;

    virtual Path getTickShape (float height) = 0;

    virtual Path getCrossShape (float height) = 0;

    virtual std::unique_ptr<DropShadower> createDropShadowerForComponent (Component&) = 0;

    virtual std::unique_ptr<FocusOutline> createFocusOutlineForComponent (Component&) = 0;
 
    //==============================================================================
    virtual MouseCursor getMouseCursorFor (Component&);

    virtual std::unique_ptr<LowLevelGraphicsContext> createGraphicsContext (const Image& imageToRenderOn,
                                                                            Point<int> origin,
                                                                            const RectangleList<int>& initialClip);

    virtual void playAlertSound();
 
private:
    //==============================================================================
    struct ColourSetting
    {
        int colourID;
        Colour colour;
 
        bool operator<  (const ColourSetting& other) const noexcept  { return colourID <  other.colourID; }
        bool operator== (const ColourSetting& other) const noexcept  { return colourID == other.colourID; }
    };
 
    SortedSet<ColourSetting> colours;
    String defaultSans, defaultSerif, defaultFixed;
    Typeface::Ptr defaultTypeface;
    bool useNativeAlertWindows = false;
 
    JUCE_DECLARE_WEAK_REFERENCEABLE (LookAndFeel)
    JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (LookAndFeel)
};
 
} // namespace juce