1 /* -*- indent-tabs-mode: nil; tab-width: 4; c-basic-offset: 4; -*-
3 stacking.h for the Openbox window manager
4 Copyright (c) 2006 Mikael Magnusson
5 Copyright (c) 2003-2007 Dana Jansens
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.
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.
17 See the COPYING file for a copy of the GNU General Public License.
29 /*! The possible stacking layers a client window can be a part of */
31 OB_STACKING_LAYER_INVALID,
32 OB_STACKING_LAYER_DESKTOP, /*!< 0 - desktop windows */
33 OB_STACKING_LAYER_BELOW, /*!< 1 - normal windows w/ below */
34 OB_STACKING_LAYER_NORMAL, /*!< 2 - normal windows */
35 OB_STACKING_LAYER_ABOVE, /*!< 3 - normal windows w/ above */
36 OB_STACKING_LAYER_FULLSCREEN, /*!< 4 - fullscreeen windows */
37 OB_STACKING_LAYER_INTERNAL, /*!< 5 - openbox windows/menus */
38 OB_NUM_STACKING_LAYERS,
39 OB_STACKING_LAYER_ALL = 0xffffffff /*!< 0xffffffff - unmamnaged windows */
42 /* list of ObWindow*s in stacking order from highest to lowest */
43 extern GList *stacking_list;
44 /* list of ObWindow*s in stacking order from lowest to highest */
45 extern GList *stacking_list_tail;
47 /*! Sets the window stacking list on the root window from the
49 void stacking_set_list(void);
51 void stacking_add(struct _ObWindow *win);
52 void stacking_add_nonintrusive(struct _ObWindow *win);
53 #define stacking_remove(win) stacking_list = g_list_remove(stacking_list, win);
55 /*! Raises a window above all others in its stacking layer */
56 void stacking_raise(struct _ObWindow *window);
58 /*! Temporarily raises a window above all others */
59 void stacking_temp_raise(struct _ObWindow *window);
61 /*! Restores any temporarily raised windows to their correct place */
62 void stacking_restore(void);
64 /*! Lowers a window below all others in its stacking layer */
65 void stacking_lower(struct _ObWindow *window);
67 /*! Moves a window below another if its in the same layer.
68 This function does not enforce stacking rules IRT transients n such, and so
69 it should really ONLY be used to restore stacking orders from saved sessions
71 void stacking_below(struct _ObWindow *window, struct _ObWindow *below);
73 /*! Restack a window based upon a sibling (or all windows) in various ways.
74 @param client The client to be restacked
75 @param sibling Another client to compare to, or NULL to compare to all
77 @param detail One of Above, Below, TopIf, BottomIf, Opposite
78 @return TRUE if the client was restacked
79 See http://tronche.com/gui/x/xlib/window/configure.html for details on
80 how each detail works with and without a sibling.
82 gboolean stacking_restack_request(struct _ObClient *client,
83 struct _ObClient *sibling,