git.sur5r.net Git - i3/i3/blob - 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_ACTIVE_WINDOW with the currently focused window.
  23  *
  24  * EWMH: The window ID of the currently active window or None if no window has
  25  * the focus.
  26  *
  27  */
  28 void ewmh_update_active_window(xcb_window_t window);
  29
  30 /**
  31  * Updates the _NET_CLIENT_LIST hint. Used for window listers.
  32  */
  33 void ewmh_update_client_list(xcb_window_t *list, int num_windows);
  34
  35 /**
  36  * Updates the _NET_CLIENT_LIST_STACKING hint. Necessary to move tabs in
  37  * Chromium correctly.
  38  *
  39  * EWMH: These arrays contain all X Windows managed by the Window Manager.
  40  * _NET_CLIENT_LIST has initial mapping order, starting with the oldest window.
  41  * _NET_CLIENT_LIST_STACKING has bottom-to-top stacking order. These properties
  42  * SHOULD be set and updated by the Window Manager.
  43  *
  44  */
  45 void ewmh_update_client_list_stacking(xcb_window_t *stack, int num_windows);
  46
  47 /**
  48  * Set up the EWMH hints on the root window.
  49  *
  50  */
  51 void ewmh_setup_hints(void);
  52
  53 /**
  54  * i3 currently does not support _NET_WORKAREA, because it does not correspond
  55  * to i3’s concept of workspaces. See also:
  56  * http://bugs.i3wm.org/539
  57  * http://bugs.i3wm.org/301
  58  * http://bugs.i3wm.org/1038
  59  *
  60  * We need to actively delete this property because some display managers (e.g.
  61  * LightDM) set it.
  62  *
  63  * EWMH: Contains a geometry for each desktop. These geometries specify an area
  64  * that is completely contained within the viewport. Work area SHOULD be used by
  65  * desktop applications to place desktop icons appropriately.
  66  *
  67  */
  68 void ewmh_update_workarea(void);