openbox/focus.h

   1 #ifndef __focus_h
   2 #define __focus_h
   3
   4 #include <X11/Xlib.h>
   5 #include <glib.h>
   6
   7 struct _ObClient;
   8
   9 /*! The client which is currently focused */
  10 extern struct _ObClient *focus_client;
  11
  12 /*! The recent focus order on each desktop */
  13 extern GList **focus_order;
  14
  15 void focus_startup();
  16 void focus_shutdown();
  17
  18 /*! Specify which client is currently focused, this doesn't actually
  19   send focus anywhere, its called by the Focus event handlers */
  20 void focus_set_client(struct _ObClient *client);
  21
  22 typedef enum {
  23     OB_FOCUS_FALLBACK_DESKTOP,    /*!< switching desktops */
  24     OB_FOCUS_FALLBACK_UNFOCUSING, /*!< forcefully remove focus from the
  25                                     current window */
  26     OB_FOCUS_FALLBACK_NOFOCUS     /*!< nothing has focus for some reason */
  27 } ObFocusFallbackType;
  28
  29 /*! Call this when you need to focus something! */
  30 void focus_fallback(ObFocusFallbackType type);
  31
  32 /*! Cycle focus amongst windows
  33   Returns the _ObClient to which focus has been cycled, or NULL if none. */
  34 struct _ObClient *focus_cycle(gboolean forward, gboolean linear,
  35                               gboolean dialog, gboolean done, gboolean cancel);
  36
  37 /*! Add a new client into the focus order */
  38 void focus_order_add_new(struct _ObClient *c);
  39
  40 /*! Remove a client from the focus order */
  41 void focus_order_remove(struct _ObClient *c);
  42
  43 /*! Move a client to the top of the focus order */
  44 void focus_order_to_top(struct _ObClient *c);
  45
  46 /*! Move a client to the bottom of the focus order (keeps iconic windows at the
  47   very bottom always though). */
  48 void focus_order_to_bottom(struct _ObClient *c);
  49
  50 #endif