juce_TopLevelWindow.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_TOPLEVELWINDOW_H_INCLUDED
#define JUCE_TOPLEVELWINDOW_H_INCLUDED
 
 
//==============================================================================
class JUCE_API  TopLevelWindow  : public Component
{
public:
    //==============================================================================
    TopLevelWindow (const String& name, bool addToDesktop);
 
    ~TopLevelWindow();
 
    //==============================================================================
    bool isActiveWindow() const noexcept                    { return isCurrentlyActive; }
 
    //==============================================================================
    void centreAroundComponent (Component* componentToCentreAround,
                                int width, int height);
 
    //==============================================================================
    void setDropShadowEnabled (bool useShadow);
 
    bool isDropShadowEnabled() const noexcept               { return useDropShadow; }
 
    void setUsingNativeTitleBar (bool useNativeTitleBar);
 
    bool isUsingNativeTitleBar() const noexcept;
 
    //==============================================================================
    static int getNumTopLevelWindows() noexcept;
 
    static TopLevelWindow* getTopLevelWindow (int index) noexcept;
 
    static TopLevelWindow* getActiveTopLevelWindow() noexcept;
 
    void addToDesktop();
 
    //==============================================================================
    void addToDesktop (int windowStyleFlags, void* nativeWindowToAttachTo = nullptr) override;
 
protected:
    //==============================================================================
    virtual void activeWindowStatusChanged();
 
 
    //==============================================================================
    void focusOfChildComponentChanged (FocusChangeType) override;
    void parentHierarchyChanged() override;
    virtual int getDesktopWindowStyleFlags() const;
    void recreateDesktopWindow();
    void visibilityChanged() override;
 
private:
    friend class TopLevelWindowManager;
    friend class ResizableWindow;
    bool useDropShadow, useNativeTitleBar, isCurrentlyActive;
    ScopedPointer<DropShadower> shadower;
 
    void setWindowActive (bool);
 
    JUCE_DECLARE_NON_COPYABLE_WITH_LEAK_DETECTOR (TopLevelWindow)
};
 
 
#endif   // JUCE_TOPLEVELWINDOW_H_INCLUDED