2 * vim:ts=4:sw=4:expandtab
4 * i3 - an improved dynamic tiling window manager
5 * © 2009-2011 Michael Stapelberg and contributors (see also: LICENSE)
7 * ewmh.c: Get/set certain EWMH properties easily.
13 * Updates _NET_CURRENT_DESKTOP with the current desktop number.
15 * EWMH: The index of the current desktop. This is always an integer between 0
16 * and _NET_NUMBER_OF_DESKTOPS - 1.
19 void ewmh_update_current_desktop(void);
22 * Updates _NET_NUMBER_OF_DESKTOPS which we interpret as the number of
23 * noninternal workspaces.
25 void ewmh_update_number_of_desktops(void);
28 * Updates _NET_DESKTOP_NAMES: "The names of all virtual desktops. This is a
29 * list of NULL-terminated strings in UTF-8 encoding"
31 void ewmh_update_desktop_names(void);
34 * Updates _NET_DESKTOP_VIEWPORT, which is an array of pairs of cardinals that
35 * define the top left corner of each desktop's viewport.
37 void ewmh_update_desktop_viewport(void);
40 * Updates _NET_ACTIVE_WINDOW with the currently focused window.
42 * EWMH: The window ID of the currently active window or None if no window has
46 void ewmh_update_active_window(xcb_window_t window);
49 * Updates the _NET_CLIENT_LIST hint. Used for window listers.
51 void ewmh_update_client_list(xcb_window_t *list, int num_windows);
54 * Updates the _NET_CLIENT_LIST_STACKING hint. Necessary to move tabs in
57 * EWMH: These arrays contain all X Windows managed by the Window Manager.
58 * _NET_CLIENT_LIST has initial mapping order, starting with the oldest window.
59 * _NET_CLIENT_LIST_STACKING has bottom-to-top stacking order. These properties
60 * SHOULD be set and updated by the Window Manager.
63 void ewmh_update_client_list_stacking(xcb_window_t *stack, int num_windows);
66 * Set up the EWMH hints on the root window.
69 void ewmh_setup_hints(void);
72 * i3 currently does not support _NET_WORKAREA, because it does not correspond
73 * to i3’s concept of workspaces. See also:
74 * http://bugs.i3wm.org/539
75 * http://bugs.i3wm.org/301
76 * http://bugs.i3wm.org/1038
78 * We need to actively delete this property because some display managers (e.g.
81 * EWMH: Contains a geometry for each desktop. These geometries specify an area
82 * that is completely contained within the viewport. Work area SHOULD be used by
83 * desktop applications to place desktop icons appropriately.
86 void ewmh_update_workarea(void);