2002-07-17 04:07:32 +08:00
|
|
|
//C++ header - Open Scene Graph - Copyright (C) 1998-2002 Robert Osfield
|
2002-05-09 18:31:03 +08:00
|
|
|
//Distributed under the terms of the GNU Library General Public License (LGPL)
|
|
|
|
//as published by the Free Software Foundation.
|
|
|
|
|
|
|
|
#ifndef OSGGA_GUIEVENTHANDLER
|
|
|
|
#define OSGGA_GUIEVENTHANDLER 1
|
|
|
|
|
|
|
|
#include <vector>
|
|
|
|
|
|
|
|
#include <osg/Referenced>
|
|
|
|
|
|
|
|
#include <osgGA/Export>
|
|
|
|
#include <osgGA/GUIEventAdapter>
|
|
|
|
#include <osgGA/GUIActionAdapter>
|
|
|
|
#include <osgGA/GUIEventHandlerVisitor>
|
|
|
|
|
|
|
|
namespace osgGA{
|
|
|
|
|
|
|
|
class CompositeGUIEventHandler;
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
|
|
|
GUIEventHandler provides a basic interface for any class which wants to handle
|
|
|
|
a GUI Events.
|
|
|
|
|
|
|
|
The GUIEvent is supplied by a GUIEventAdapter. Feedback resulting from the
|
|
|
|
handle method is supplied by a GUIActionAdapter, which allows the GUIEventHandler
|
|
|
|
to ask the GUI to take some action in response to an incoming event.
|
|
|
|
|
|
|
|
For example, consider a Trackball Viewer class which takes mouse events and
|
|
|
|
manipulates a scene camera in response. The Trackball Viewer is a GUIEventHandler,
|
|
|
|
and receives the events via the handle method. If the user 'throws' the model,
|
|
|
|
the Trackball Viewer class can detect this via the incoming events, and
|
|
|
|
request that the GUI set up a timer callback to continually redraw the view.
|
|
|
|
This request is made via the GUIActionAdapter class.
|
|
|
|
|
|
|
|
*/
|
|
|
|
|
|
|
|
class OSGGA_EXPORT GUIEventHandler : public osg::Referenced
|
|
|
|
{
|
2002-08-28 22:27:18 +08:00
|
|
|
public:
|
2002-05-09 18:31:03 +08:00
|
|
|
|
2002-08-28 22:27:18 +08:00
|
|
|
/** Handle events, return true if handled, false otherwise. */
|
2002-05-09 18:31:03 +08:00
|
|
|
virtual bool handle(const GUIEventAdapter& ea,GUIActionAdapter& us)=0;
|
|
|
|
|
2002-08-28 22:27:18 +08:00
|
|
|
/** Returns 0 if this GUIEventHandler is not a CompositeGUIEventHandler. */
|
2002-05-09 18:31:03 +08:00
|
|
|
virtual const CompositeGUIEventHandler* getComposite() const { return 0; }
|
|
|
|
|
2002-08-28 22:27:18 +08:00
|
|
|
/** Returns 0 if this GUIEventHandler is not a CompositeGUIEventHandler. */
|
2002-05-09 18:31:03 +08:00
|
|
|
virtual CompositeGUIEventHandler* getComposite() { return 0; }
|
|
|
|
|
|
|
|
/** Accept visits from GUIEventHandler visitors */
|
|
|
|
virtual void accept(GUIEventHandlerVisitor&) = 0;
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
CompositeGUIEventHandler allows GUIEventHandlers to be composed into hierarchies.
|
|
|
|
*/
|
|
|
|
|
|
|
|
class OSGGA_EXPORT CompositeGUIEventHandler : public GUIEventHandler
|
|
|
|
{
|
2002-08-28 22:27:18 +08:00
|
|
|
public:
|
2002-05-09 18:31:03 +08:00
|
|
|
|
|
|
|
typedef std::vector< osg::ref_ptr<GUIEventHandler> > ChildList;
|
|
|
|
|
|
|
|
virtual bool handle(const GUIEventAdapter& ea,GUIActionAdapter& aa);
|
|
|
|
|
|
|
|
virtual const CompositeGUIEventHandler* getComposite() const { return this; }
|
|
|
|
|
|
|
|
virtual CompositeGUIEventHandler* getComposite() { return this; }
|
|
|
|
|
|
|
|
virtual void accept(GUIEventHandlerVisitor& v) { v.visit(*this); }
|
|
|
|
|
2002-08-28 22:27:18 +08:00
|
|
|
// Composite-specific methods below
|
2002-05-09 18:31:03 +08:00
|
|
|
|
|
|
|
virtual bool addChild(GUIEventHandler *geh);
|
|
|
|
|
|
|
|
virtual bool removeChild(GUIEventHandler *geh);
|
|
|
|
|
|
|
|
const int getNumChildren() const { return _children.size(); }
|
|
|
|
|
|
|
|
GUIEventHandler *getChild( int i) { return _children[i].get(); }
|
|
|
|
|
|
|
|
const GUIEventHandler *getChild( int i ) const { return _children[i].get(); }
|
|
|
|
|
|
|
|
bool containsNode( const GUIEventHandler* node ) const
|
|
|
|
{
|
2002-08-28 22:27:18 +08:00
|
|
|
for (ChildList::const_iterator itr=_children.begin();
|
|
|
|
itr!=_children.end();
|
|
|
|
++itr)
|
|
|
|
{
|
|
|
|
if (itr->get()==node) return true;
|
|
|
|
}
|
|
|
|
return false;
|
2002-05-09 18:31:03 +08:00
|
|
|
}
|
|
|
|
|
|
|
|
ChildList::iterator findChild( const GUIEventHandler* node )
|
|
|
|
{
|
2002-08-28 22:27:18 +08:00
|
|
|
for (ChildList::iterator itr=_children.begin();
|
|
|
|
itr!=_children.end();
|
|
|
|
++itr)
|
|
|
|
{
|
|
|
|
if (itr->get()==node) return itr;
|
|
|
|
}
|
|
|
|
return _children.end();
|
2002-05-09 18:31:03 +08:00
|
|
|
}
|
|
|
|
|
2002-08-28 22:27:18 +08:00
|
|
|
private:
|
2002-05-09 18:31:03 +08:00
|
|
|
|
|
|
|
ChildList _children;
|
|
|
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
}
|
|
|
|
|
|
|
|
#endif
|