4 * i3 - an improved dynamic tiling window manager
6 * © 2009-2010 Michael Stapelberg and contributors
8 * See file LICENSE for license information.
14 #include <xcb/randr.h>
17 void add_ignore_event(const int sequence);
20 * There was a key press. We compare this key code with our bindings table and
21 * pass the bound action to parse_command().
24 int handle_key_press(void *ignored, xcb_connection_t *conn,
25 xcb_key_press_event_t *event);
28 * When the user moves the mouse pointer onto a window, this callback gets
32 int handle_enter_notify(void *ignored, xcb_connection_t *conn,
33 xcb_enter_notify_event_t *event);
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.
42 int handle_motion_notify(void *ignored, xcb_connection_t *conn,
43 xcb_motion_notify_event_t *event);
46 * Called when the keyboard mapping changes (for example by using Xmodmap),
47 * we need to update our key bindings then (re-translate symbols).
50 int handle_mapping_notify(void *ignored, xcb_connection_t *conn,
51 xcb_mapping_notify_event_t *event);
54 * Checks if the button press was on a stack window, handles focus setting and
55 * returns true if so, or false otherwise.
58 int handle_button_press(void *ignored, xcb_connection_t *conn,
59 xcb_button_press_event_t *event);
62 * A new window appeared on the screen (=was mapped), so let’s manage it.
65 int handle_map_request(void *prophs, xcb_connection_t *conn,
66 xcb_map_request_event_t *event);
69 * Configuration notifies are only handled because we need to set up ignore
70 * for the following enter notify events
73 int handle_configure_event(void *prophs, xcb_connection_t *conn, xcb_configure_notify_event_t *event);
76 * Gets triggered upon a RandR screen change event, that is when the user
77 * changes the screen configuration in any way (mode, position, …)
80 int handle_screen_change(void *prophs, xcb_connection_t *conn,
81 xcb_generic_event_t *e);
85 * Configure requests are received when the application wants to resize
86 * windows on their own.
88 * We generate a synthethic configure notify event to signalize the client its
92 int handle_configure_request(void *prophs, xcb_connection_t *conn,
93 xcb_configure_request_event_t *event);
96 * Our window decorations were unmapped. That means, the window will be killed
97 * now, so we better clean up before.
100 int handle_unmap_notify_event(void *data, xcb_connection_t *conn, xcb_unmap_notify_event_t *event);
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).
107 * We just pass on the event to the unmap notify handler (by copying the
108 * important fields in the event data structure).
111 int handle_destroy_notify_event(void *data, xcb_connection_t *conn,
112 xcb_destroy_notify_event_t *event);
115 * Called when a window changes its title
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);
122 * Handles legacy window name updates (WM_NAME), see also src/window.c,
123 * window_update_name_legacy().
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
133 * Store the window classes for jumping to them later.
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);
142 * Expose event means we should redraw our windows (= title bar)
145 int handle_expose_event(void *data, xcb_connection_t *conn,
146 xcb_expose_event_t *event);
148 * Handle client messages (EWMH)
151 int handle_client_message(void *data, xcb_connection_t *conn,
152 xcb_client_message_event_t *event);
156 * Handles _NET_WM_WINDOW_TYPE changes
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);
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)
169 * See ICCCM 4.1.2.3 for more details
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);
177 * Handles the WM_HINTS property for extracting the urgency state of the window.
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);
185 * Handles the transient for hints set by a window, signalizing that this
186 * window is a popup window for some other window.
188 * See ICCCM 4.1.2.6 for more details
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);
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).
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);