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

   1 /*
   2  * vim:ts=8:expandtab
   3  *
   4  * i3 - an improved dynamic tiling window manager
   5  *
   6  * © 2009-2010 Michael Stapelberg and contributors
   7  *
   8  * See file LICENSE for license information.
   9  *
  10  */
  11 #ifndef _HANDLERS_H
  12 #define _HANDLERS_H
  13
  14 #include <xcb/randr.h>
  15
  16
  17 void add_ignore_event(const int sequence);
  18
  19 /**
  20  * There was a key press. We compare this key code with our bindings table and
  21  * pass the bound action to parse_command().
  22  *
  23  */
  24 int handle_key_press(void *ignored, xcb_connection_t *conn,
  25                      xcb_key_press_event_t *event);
  26
  27 /**
  28  * When the user moves the mouse pointer onto a window, this callback gets
  29  * called.
  30  *
  31  */
  32 int handle_enter_notify(void *ignored, xcb_connection_t *conn,
  33                         xcb_enter_notify_event_t *event);
  34
  35 #if 0
  36 /**
  37  * When the user moves the mouse but does not change the active window
  38  * (e.g. when having no windows opened but moving mouse on the root screen
  39  * and crossing virtual screen boundaries), this callback gets called.
  40  *
  41  */
  42 int handle_motion_notify(void *ignored, xcb_connection_t *conn,
  43                          xcb_motion_notify_event_t *event);
  44
  45 /**
  46  * Called when the keyboard mapping changes (for example by using Xmodmap),
  47  * we need to update our key bindings then (re-translate symbols).
  48  *
  49  */
  50 int handle_mapping_notify(void *ignored, xcb_connection_t *conn,
  51                           xcb_mapping_notify_event_t *event);
  52
  53 /**
  54  * Checks if the button press was on a stack window, handles focus setting and
  55  * returns true if so, or false otherwise.
  56  *
  57  */
  58 int handle_button_press(void *ignored, xcb_connection_t *conn,
  59                         xcb_button_press_event_t *event);
  60 #endif
  61 /**
  62  * A new window appeared on the screen (=was mapped), so let’s manage it.
  63  *
  64  */
  65 int handle_map_request(void *prophs, xcb_connection_t *conn,
  66                        xcb_map_request_event_t *event);
  67 #if 0
  68 /**
  69  * Configuration notifies are only handled because we need to set up ignore
  70  * for the following enter notify events
  71  *
  72  */
  73 int handle_configure_event(void *prophs, xcb_connection_t *conn, xcb_configure_notify_event_t *event);
  74
  75 /**
  76  * Gets triggered upon a RandR screen change event, that is when the user
  77  * changes the screen configuration in any way (mode, position, …)
  78  *
  79  */
  80 int handle_screen_change(void *prophs, xcb_connection_t *conn,
  81                          xcb_generic_event_t *e);
  82 #endif
  83
  84 /**
  85  * Configure requests are received when the application wants to resize
  86  * windows on their own.
  87  *
  88  * We generate a synthethic configure notify event to signalize the client its
  89  * "new" position.
  90  *
  91  */
  92 int handle_configure_request(void *prophs, xcb_connection_t *conn,
  93                              xcb_configure_request_event_t *event);
  94
  95 /**
  96  * Our window decorations were unmapped. That means, the window will be killed
  97  * now, so we better clean up before.
  98  *
  99  */
 100 int handle_unmap_notify_event(void *data, xcb_connection_t *conn, xcb_unmap_notify_event_t *event);
 101
 102 /**
 103  * A destroy notify event is sent when the window is not unmapped, but
 104  * immediately destroyed (for example when starting a window and immediately
 105  * killing the program which started it).
 106  *
 107  * We just pass on the event to the unmap notify handler (by copying the
 108  * important fields in the event data structure).
 109  *
 110  */
 111 int handle_destroy_notify_event(void *data, xcb_connection_t *conn,
 112                                 xcb_destroy_notify_event_t *event);
 113
 114 /**
 115  * Called when a window changes its title
 116  *
 117  */
 118 int handle_windowname_change(void *data, xcb_connection_t *conn, uint8_t state,
 119                              xcb_window_t window, xcb_atom_t atom,
 120                              xcb_get_property_reply_t *prop);
 121 /**
 122  * Handles legacy window name updates (WM_NAME), see also src/window.c,
 123  * window_update_name_legacy().
 124  *
 125  */
 126 int handle_windowname_change_legacy(void *data, xcb_connection_t *conn,
 127                                     uint8_t state, xcb_window_t window,
 128                                     xcb_atom_t atom, xcb_get_property_reply_t
 129                                     *prop);
 130
 131 #if 0
 132 /**
 133  * Store the window classes for jumping to them later.
 134  *
 135  */
 136 int handle_windowclass_change(void *data, xcb_connection_t *conn, uint8_t state,
 137                               xcb_window_t window, xcb_atom_t atom,
 138                               xcb_get_property_reply_t *prop);
 139
 140 #endif
 141 /**
 142  * Expose event means we should redraw our windows (= title bar)
 143  *
 144  */
 145 int handle_expose_event(void *data, xcb_connection_t *conn,
 146                         xcb_expose_event_t *event);
 147 /**
 148  * Handle client messages (EWMH)
 149  *
 150  */
 151 int handle_client_message(void *data, xcb_connection_t *conn,
 152                           xcb_client_message_event_t *event);
 153
 154 #if 0
 155 /**
 156  * Handles _NET_WM_WINDOW_TYPE changes
 157  *
 158  */
 159 int handle_window_type(void *data, xcb_connection_t *conn, uint8_t state,
 160                        xcb_window_t window, xcb_atom_t atom,
 161                        xcb_get_property_reply_t *property);
 162 #endif
 163
 164 /**
 165  * Handles the size hints set by a window, but currently only the part
 166  * necessary for displaying clients proportionally inside their frames
 167  * (mplayer for example)
 168  *
 169  * See ICCCM 4.1.2.3 for more details
 170  *
 171  */
 172 int handle_normal_hints(void *data, xcb_connection_t *conn, uint8_t state,
 173                         xcb_window_t window, xcb_atom_t name,
 174                         xcb_get_property_reply_t *reply);
 175
 176 /**
 177  * Handles the WM_HINTS property for extracting the urgency state of the window.
 178  *
 179  */
 180 int handle_hints(void *data, xcb_connection_t *conn, uint8_t state, xcb_window_t window,
 181                   xcb_atom_t name, xcb_get_property_reply_t *reply);
 182 #if 0
 183
 184 /**
 185  * Handles the transient for hints set by a window, signalizing that this
 186  * window is a popup window for some other window.
 187  *
 188  * See ICCCM 4.1.2.6 for more details
 189  *
 190  */
 191 int handle_transient_for(void *data, xcb_connection_t *conn, uint8_t state,
 192                          xcb_window_t window, xcb_atom_t name,
 193                          xcb_get_property_reply_t *reply);
 194
 195 /**
 196  * Handles changes of the WM_CLIENT_LEADER atom which specifies if this is a
 197  * toolwindow (or similar) and to which window it belongs (logical parent).
 198  *
 199  */
 200 int handle_clientleader_change(void *data, xcb_connection_t *conn,
 201                                uint8_t state, xcb_window_t window,
 202                                xcb_atom_t name, xcb_get_property_reply_t *prop);
 203 #endif
 204
 205 #endif