juce_Desktop.h

Go to the documentation of this file.

/*
  ==============================================================================

   This file is part of the JUCE library - "Jules' Utility Class Extensions"
   Copyright 2004-7 by Raw Material Software ltd.

  ------------------------------------------------------------------------------

   JUCE can be redistributed and/or modified under the terms of the
   GNU General Public License, as published by the Free Software Foundation;
   either version 2 of the License, or (at your option) any later version.

   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.

   You should have received a copy of the GNU General Public License
   along with JUCE; if not, visit www.gnu.org/licenses or write to the
   Free Software Foundation, Inc., 59 Temple Place, Suite 330,
   Boston, MA 02111-1307 USA

  ------------------------------------------------------------------------------

   If you'd like to release a closed-source product which uses JUCE, commercial
   licenses are also available: visit www.rawmaterialsoftware.com/juce for
   more information.

  ==============================================================================
*/

#ifndef __JUCE_DESKTOP_JUCEHEADER__
#define __JUCE_DESKTOP_JUCEHEADER__

#include "juce_Component.h"
#include "../../application/juce_DeletedAtShutdown.h"
#include "../../events/juce_Timer.h"
#include "../../events/juce_AsyncUpdater.h"
#include "../../../juce_core/containers/juce_SortedSet.h"


//==============================================================================
class JUCE_API  FocusChangeListener
{
public:
    virtual ~FocusChangeListener()  {}

    virtual void globalFocusChanged (Component* focusedComponent) = 0;
};


//==============================================================================
class JUCE_API  Desktop  : private DeletedAtShutdown,
                           private Timer,
                           private AsyncUpdater
{
public:
    //==============================================================================
    static Desktop& JUCE_CALLTYPE getInstance() throw();

    //==============================================================================
    const RectangleList getAllMonitorDisplayAreas (const bool clippedToWorkArea = true) const throw();

    const Rectangle getMainMonitorArea (const bool clippedToWorkArea = true) const throw();

    const Rectangle getMonitorAreaContaining (int x, int y, const bool clippedToWorkArea = true) const throw();


    //==============================================================================
    static void getMousePosition (int& x, int& y) throw();

    static void setMousePosition (int x, int y) throw();

    static void getLastMouseDownPosition (int& x, int& y) throw();

    static int getMouseButtonClickCounter() throw();

    //==============================================================================
    static void setScreenSaverEnabled (const bool isEnabled) throw();

    static bool isScreenSaverEnabled() throw();

    //==============================================================================
    void addGlobalMouseListener (MouseListener* const listener) throw();

    void removeGlobalMouseListener (MouseListener* const listener) throw();

    //==============================================================================
    void addFocusChangeListener (FocusChangeListener* const listener) throw();

    void removeFocusChangeListener (FocusChangeListener* const listener) throw();

    //==============================================================================
    int getNumComponents() const throw();

    Component* getComponent (const int index) const throw();

    Component* findComponentAt (const int screenX,
                                const int screenY) const;


    //==============================================================================
    juce_UseDebuggingNewOperator

    void refreshMonitorSizes() throw();

    static bool canUseSemiTransparentWindows() throw();


private:
    //==============================================================================
    friend class Component;
    friend class ComponentPeer;
    SortedSet <void*> mouseListeners, focusListeners;
    VoidArray desktopComponents;

    friend class DeletedAtShutdown;
    friend class TopLevelWindowManager;
    Desktop() throw();
    ~Desktop() throw();

    Array <Rectangle> monitorCoordsClipped, monitorCoordsUnclipped;
    int lastMouseX, lastMouseY;

    void timerCallback();
    void sendMouseMove();
    void resetTimer() throw();

    int getNumDisplayMonitors() const throw();
    const Rectangle getDisplayMonitorCoordinates (const int index, const bool clippedToWorkArea) const throw();

    void addDesktopComponent (Component* const c) throw();
    void removeDesktopComponent (Component* const c) throw();
    void componentBroughtToFront (Component* const c) throw();

    void triggerFocusCallback() throw();
    void handleAsyncUpdate();

    Desktop (const Desktop&);
    const Desktop& operator= (const Desktop&);
};


#endif   // __JUCE_DESKTOP_JUCEHEADER__