src/actions.hh

   1 // -*- mode: C++; indent-tabs-mode: nil; c-basic-offset: 2; -*-
   2 #ifndef __actions_hh
   3 #define __actions_hh
   4
   5 /*! @file actions.hh
   6   @brief The action interface for user-available actions
   7 */
   8
   9 #include "widget.hh"
  10 #include "otk/point.hh"
  11 #include "otk/rect.hh"
  12 #include "otk/eventhandler.hh"
  13
  14 extern "C" {
  15 #include <X11/Xlib.h>
  16 #include <Python.h>
  17 }
  18
  19 #include <map>
  20
  21 namespace ob {
  22
  23 //! The action interface for user-available actions
  24 /*!
  25   When these actions are fired, hooks to the guile engine are fired so that
  26   guile code is run.
  27 */
  28 class OBActions : public otk::OtkEventHandler {
  29 public:
  30   // update the same enum in openbox.i when making changes to this
  31   enum ActionType {
  32     Action_ButtonPress,
  33     Action_Click,
  34     Action_DoubleClick,
  35     Action_EnterWindow,
  36     Action_LeaveWindow,
  37     Action_KeyPress,
  38     Action_MouseMotion,
  39     Action_NewWindow,
  40     Action_CloseWindow,
  41     NUM_ACTIONS
  42   };
  43
  44   struct ButtonReleaseAction {
  45     Window win;
  46     unsigned int button;
  47     Time time;
  48     ButtonReleaseAction() { win = 0; button = 0; time = 0; }
  49   };
  50
  51 private:
  52   // milliseconds XXX: config option
  53   static const unsigned int DOUBLECLICKDELAY;
  54
  55   //! The mouse button currently being watched from a press for a CLICK
  56   unsigned int _button;
  57   //! The last button release processed for CLICKs
  58   ButtonReleaseAction _release;
  59
  60   typedef std::multimap<ActionType, PyObject*> CallbackMap;
  61   typedef std::pair<ActionType, PyObject*> CallbackMapPair;
  62   CallbackMap _callbacks;
  63
  64   void doCallback(ActionType action, Window window, OBWidget::WidgetType type,
  65                   unsigned int state, unsigned int button,
  66                   int xroot, int yroot, Time time);
  67
  68 public:
  69   //! Constructs an OBActions object
  70   OBActions();
  71   //! Destroys the OBActions object
  72   virtual ~OBActions();
  73
  74   virtual void buttonPressHandler(const XButtonEvent &e);
  75   virtual void buttonReleaseHandler(const XButtonEvent &e);
  76
  77   virtual void enterHandler(const XCrossingEvent &e);
  78   virtual void leaveHandler(const XCrossingEvent &e);
  79
  80   virtual void keyPressHandler(const XKeyEvent &e);
  81
  82   virtual void motionHandler(const XMotionEvent &e);
  83
  84   virtual void mapRequestHandler(const XMapRequestEvent &e);
  85   virtual void unmapHandler(const XUnmapEvent &e);
  86   virtual void destroyHandler(const XDestroyWindowEvent &e);
  87
  88
  89   //! Add a callback funtion to the back of the hook list
  90   /*!
  91     Registering functions for KeyPress events is pointless. Use
  92     OBSCript::bindKey instead to do this.
  93   */
  94   bool registerCallback(ActionType action, PyObject *func, bool atfront);
  95
  96   //! Remove a callback function from the hook list
  97   bool unregisterCallback(ActionType action, PyObject *func);
  98
  99   //! Remove all callback functions from the hook list
 100   bool unregisterAllCallbacks(ActionType action);
 101 };
 102
 103 }
 104
 105 #endif // __actions_hh