openbox/focus.h

   1 /* -*- indent-tabs-mode: nil; tab-width: 4; c-basic-offset: 4; -*-
   2
   3    focus.h for the Openbox window manager
   4    Copyright (c) 2006        Mikael Magnusson
   5    Copyright (c) 2003        Ben Jansens
   6
   7    This program is free software; you can redistribute it and/or modify
   8    it under the terms of the GNU General Public License as published by
   9    the Free Software Foundation; either version 2 of the License, or
  10    (at your option) any later version.
  11
  12    This program is distributed in the hope that it will be useful,
  13    but WITHOUT ANY WARRANTY; without even the implied warranty of
  14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15    GNU General Public License for more details.
  16
  17    See the COPYING file for a copy of the GNU General Public License.
  18 */
  19
  20 #ifndef __focus_h
  21 #define __focus_h
  22
  23 #include "misc.h"
  24
  25 #include <X11/Xlib.h>
  26 #include <glib.h>
  27
  28 struct _ObClient;
  29
  30 /*! The client which is currently focused */
  31 extern struct _ObClient *focus_client;
  32 /*! The client which is being decorated as focused, not always matching the
  33   real focus, but this is used to track it so that it can be resolved to match.
  34
  35   This is for when you change desktops. We know which window is *going to be*
  36   focused, so we hilight it. But since it's hilighted, we also want
  37   keybindings to go to it, which is really what this is for.
  38 */
  39 extern struct _ObClient *focus_hilite;
  40 /*! The client which appears focused during a focus cycle operation */
  41 extern struct _ObClient *focus_cycle_target;
  42
  43 /*! The recent focus order on each desktop */
  44 extern GList *focus_order;
  45
  46 void focus_startup(gboolean reconfig);
  47 void focus_shutdown(gboolean reconfig);
  48
  49 /*! Specify which client is currently focused, this doesn't actually
  50   send focus anywhere, its called by the Focus event handlers */
  51 void focus_set_client(struct _ObClient *client);
  52
  53 struct _ObClient* focus_fallback_target(gboolean allow_refocus,
  54                                         struct _ObClient *old);
  55
  56 /*! Call this when you need to focus something! */
  57 void focus_fallback(gboolean allow_refocus);
  58
  59 /*! Cycle focus amongst windows. */
  60 void focus_cycle(gboolean forward, gboolean linear, gboolean interactive,
  61                  gboolean dialog, gboolean done, gboolean cancel);
  62 void focus_directional_cycle(ObDirection dir, gboolean interactive,
  63                              gboolean dialog, gboolean done, gboolean cancel);
  64 void focus_cycle_draw_indicator();
  65
  66 /*! Add a new client into the focus order */
  67 void focus_order_add_new(struct _ObClient *c);
  68
  69 /*! Remove a client from the focus order */
  70 void focus_order_remove(struct _ObClient *c);
  71
  72 /*! Move a client to the top of the focus order */
  73 void focus_order_to_top(struct _ObClient *c);
  74
  75 /*! Move a client to the bottom of the focus order (keeps iconic windows at the
  76   very bottom always though). */
  77 void focus_order_to_bottom(struct _ObClient *c);
  78
  79 struct _ObClient *focus_order_find_first(guint desktop);
  80
  81 #endif