git.sur5r.net Git - i3/i3/blob - include/window.h

   1 /*
   2  * vim:ts=4:sw=4:expandtab
   3  *
   4  * i3 - an improved dynamic tiling window manager
   5  * © 2009 Michael Stapelberg and contributors (see also: LICENSE)
   6  *
   7  * window.c: Updates window attributes (X11 hints/properties).
   8  *
   9  */
  10 #pragma once
  11
  12 #include <config.h>
  13
  14 /**
  15  * Frees an i3Window and all its members.
  16  *
  17  */
  18 void window_free(i3Window *win);
  19
  20 /**
  21  * Updates the WM_CLASS (consisting of the class and instance) for the
  22  * given window.
  23  *
  24  */
  25 void window_update_class(i3Window *win, xcb_get_property_reply_t *prop, bool before_mgmt);
  26
  27 /**
  28  * Updates the name by using _NET_WM_NAME (encoded in UTF-8) for the given
  29  * window. Further updates using window_update_name_legacy will be ignored.
  30  *
  31  */
  32 void window_update_name(i3Window *win, xcb_get_property_reply_t *prop, bool before_mgmt);
  33
  34 /**
  35  * Updates the name by using WM_NAME (encoded in COMPOUND_TEXT). We do not
  36  * touch what the client sends us but pass it to xcb_image_text_8. To get
  37  * proper unicode rendering, the application has to use _NET_WM_NAME (see
  38  * window_update_name()).
  39  *
  40  */
  41 void window_update_name_legacy(i3Window *win, xcb_get_property_reply_t *prop, bool before_mgmt);
  42
  43 /**
  44  * Updates the CLIENT_LEADER (logical parent window).
  45  *
  46  */
  47 void window_update_leader(i3Window *win, xcb_get_property_reply_t *prop);
  48
  49 /**
  50  * Updates the TRANSIENT_FOR (logical parent window).
  51  *
  52  */
  53 void window_update_transient_for(i3Window *win, xcb_get_property_reply_t *prop);
  54
  55 /**
  56  * Updates the _NET_WM_STRUT_PARTIAL (reserved pixels at the screen edges)
  57  *
  58  */
  59 void window_update_strut_partial(i3Window *win, xcb_get_property_reply_t *prop);
  60
  61 /**
  62  * Updates the WM_WINDOW_ROLE
  63  *
  64  */
  65 void window_update_role(i3Window *win, xcb_get_property_reply_t *prop, bool before_mgmt);
  66
  67 /**
  68  * Updates the _NET_WM_WINDOW_TYPE property.
  69  *
  70  */
  71 void window_update_type(i3Window *window, xcb_get_property_reply_t *reply);
  72
  73 /**
  74  * Updates the WM_HINTS (we only care about the input focus handling part).
  75  *
  76  */
  77 void window_update_hints(i3Window *win, xcb_get_property_reply_t *prop, bool *urgency_hint);
  78
  79 /**
  80  * Updates the MOTIF_WM_HINTS. The container's border style should be set to
  81  * `motif_border_style' if border style is not BS_NORMAL.
  82  *
  83  * i3 only uses this hint when it specifies a window should have no
  84  * title bar, or no decorations at all, which is how most window managers
  85  * handle it.
  86  *
  87  * The EWMH spec intended to replace Motif hints with _NET_WM_WINDOW_TYPE, but
  88  * it is still in use by popular widget toolkits such as GTK+ and Java AWT.
  89  *
  90  */
  91 void window_update_motif_hints(i3Window *win, xcb_get_property_reply_t *prop, border_style_t *motif_border_style);