]> git.sur5r.net Git - i3/i3/blob - include/ewmh.h
Implement EWMH number of desktops property
[i3/i3] / include / ewmh.h
1 /*
2  * vim:ts=4:sw=4:expandtab
3  *
4  * i3 - an improved dynamic tiling window manager
5  * © 2009-2011 Michael Stapelberg and contributors (see also: LICENSE)
6  *
7  * ewmh.c: Get/set certain EWMH properties easily.
8  *
9  */
10 #pragma once
11
12 /**
13  * Updates _NET_CURRENT_DESKTOP with the current desktop number.
14  *
15  * EWMH: The index of the current desktop. This is always an integer between 0
16  * and _NET_NUMBER_OF_DESKTOPS - 1.
17  *
18  */
19 void ewmh_update_current_desktop(void);
20
21 /**
22  * Updates _NET_NUMBER_OF_DESKTOPS which we interpret as the number of
23  * noninternal workspaces.
24  */
25 void ewmh_update_number_of_desktops(void);
26
27 /**
28  * Updates _NET_ACTIVE_WINDOW with the currently focused window.
29  *
30  * EWMH: The window ID of the currently active window or None if no window has
31  * the focus.
32  *
33  */
34 void ewmh_update_active_window(xcb_window_t window);
35
36 /**
37  * Updates the _NET_CLIENT_LIST hint. Used for window listers.
38  */
39 void ewmh_update_client_list(xcb_window_t *list, int num_windows);
40
41 /**
42  * Updates the _NET_CLIENT_LIST_STACKING hint. Necessary to move tabs in
43  * Chromium correctly.
44  *
45  * EWMH: These arrays contain all X Windows managed by the Window Manager.
46  * _NET_CLIENT_LIST has initial mapping order, starting with the oldest window.
47  * _NET_CLIENT_LIST_STACKING has bottom-to-top stacking order. These properties
48  * SHOULD be set and updated by the Window Manager.
49  *
50  */
51 void ewmh_update_client_list_stacking(xcb_window_t *stack, int num_windows);
52
53 /**
54  * Set up the EWMH hints on the root window.
55  *
56  */
57 void ewmh_setup_hints(void);
58
59 /**
60  * i3 currently does not support _NET_WORKAREA, because it does not correspond
61  * to i3’s concept of workspaces. See also:
62  * http://bugs.i3wm.org/539
63  * http://bugs.i3wm.org/301
64  * http://bugs.i3wm.org/1038
65  *
66  * We need to actively delete this property because some display managers (e.g.
67  * LightDM) set it.
68  *
69  * EWMH: Contains a geometry for each desktop. These geometries specify an area
70  * that is completely contained within the viewport. Work area SHOULD be used by
71  * desktop applications to place desktop icons appropriately.
72  *
73  */
74 void ewmh_update_workarea(void);