mouseGrabber.h

/****************************************************************************

 Copyright (C) 2002-2008 Gilles Debunne. All rights reserved.

 This file is part of the QGLViewer library version 2.3.10.

 http://www.libqglviewer.com - contact@libqglviewer.com

 This file may be used under the terms of the GNU General Public License 
 versions 2.0 or 3.0 as published by the Free Software Foundation and
 appearing in the LICENSE file included in the packaging of this file.
 In addition, as a special exception, Gilles Debunne gives you certain 
 additional rights, described in the file GPL_EXCEPTION in this package.

 libQGLViewer uses dual licensing. Commercial/proprietary software must
 purchase a libQGLViewer Commercial License.

 This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
 WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.

*****************************************************************************/

#ifndef QGLVIEWER_MOUSE_GRABBER_H
#define QGLVIEWER_MOUSE_GRABBER_H

#include "config.h"

#if QT_VERSION >= 0x040000
# include <QEvent>
#else
# include <qevent.h>
#endif

class QGLViewer;

namespace qglviewer {
  class Camera;

  class QGLVIEWER_EXPORT MouseGrabber
  {
#ifndef DOXYGEN
    friend class ::QGLViewer;
#endif

  public:
    MouseGrabber();
#if QT_VERSION >= 0x040000
    virtual ~MouseGrabber() { MouseGrabber::MouseGrabberPool_.removeAll(this); };
#else
    virtual ~MouseGrabber() { MouseGrabber::MouseGrabberPool_.removeRef(this); };
#endif

  public:
    virtual void checkIfGrabsMouse(int x, int y, const Camera* const camera) = 0;

    bool grabsMouse() const { return grabsMouse_; };

  protected:
    void setGrabsMouse(bool grabs) { grabsMouse_ = grabs; };


  public:
#if QT_VERSION >= 0x040000
    static const QList<MouseGrabber*>& MouseGrabberPool() { return MouseGrabber::MouseGrabberPool_; };
#else
# if QT_VERSION >= 0x030000
    static const QPtrList<MouseGrabber>& MouseGrabberPool() { return MouseGrabber::MouseGrabberPool_; };
# else
    static const QList<MouseGrabber>& MouseGrabberPool() { return MouseGrabber::MouseGrabberPool_; };
# endif
#endif

#if QT_VERSION >= 0x040000
    bool isInMouseGrabberPool() const { return MouseGrabber::MouseGrabberPool_.contains(const_cast<MouseGrabber*>(this)); };
#else
    bool isInMouseGrabberPool() const { return MouseGrabber::MouseGrabberPool_.findRef(this) != -1; };
#endif
    void addInMouseGrabberPool();
    void removeFromMouseGrabberPool();
    void clearMouseGrabberPool(bool autoDelete=false);


  protected:
    virtual void mousePressEvent(QMouseEvent* const event, Camera* const camera) { Q_UNUSED(event) Q_UNUSED(camera) };
    virtual void mouseDoubleClickEvent(QMouseEvent* const event, Camera* const camera) { Q_UNUSED(event) Q_UNUSED(camera) };
    virtual void mouseReleaseEvent(QMouseEvent* const event, Camera* const camera) { Q_UNUSED(event) Q_UNUSED(camera) };
    virtual void mouseMoveEvent(QMouseEvent* const event, Camera* const camera) { Q_UNUSED(event) Q_UNUSED(camera) };
    virtual void wheelEvent(QWheelEvent* const event, Camera* const camera) { Q_UNUSED(event) Q_UNUSED(camera) };

  private:
    // Copy constructor and opertor= are declared private and undefined
    // Prevents everyone from trying to use them
    MouseGrabber(const MouseGrabber&);
    MouseGrabber& operator=(const MouseGrabber&);

    bool grabsMouse_;

    // Q G L V i e w e r   p o o l
#if QT_VERSION >= 0x040000
    static QList<MouseGrabber*> MouseGrabberPool_;
#else
    static QPtrList<MouseGrabber> MouseGrabberPool_;
#endif
  };

} // namespace qglviewer

#endif // QGLVIEWER_MOUSE_GRABBER_H