2009-02-14 02:33:31 +01:00
|
|
|
|
/*
|
|
|
|
|
* vim:ts=8:expandtab
|
|
|
|
|
*
|
|
|
|
|
* i3 - an improved dynamic tiling window manager
|
|
|
|
|
*
|
2010-03-02 12:47:21 +01:00
|
|
|
|
* © 2009-2010 Michael Stapelberg and contributors
|
2009-02-14 02:33:31 +01:00
|
|
|
|
*
|
|
|
|
|
* See file LICENSE for license information.
|
|
|
|
|
*
|
|
|
|
|
*/
|
2009-02-13 19:04:45 +01:00
|
|
|
|
#ifndef _HANDLERS_H
|
|
|
|
|
#define _HANDLERS_H
|
|
|
|
|
|
2010-03-02 12:47:21 +01:00
|
|
|
|
#include <xcb/randr.h>
|
|
|
|
|
|
2011-03-18 14:36:36 +01:00
|
|
|
|
extern int randr_base;
|
2010-04-13 20:51:43 +02:00
|
|
|
|
|
|
|
|
|
void add_ignore_event(const int sequence);
|
|
|
|
|
|
2011-03-18 14:36:36 +01:00
|
|
|
|
/**
|
|
|
|
|
* Takes an xcb_generic_event_t and calls the appropriate handler, based on the
|
|
|
|
|
* event type.
|
|
|
|
|
*
|
|
|
|
|
*/
|
|
|
|
|
void handle_event(int type, xcb_generic_event_t *event);
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Sets the appropriate atoms for the property handlers after the atoms were
|
|
|
|
|
* received from X11
|
|
|
|
|
*
|
|
|
|
|
*/
|
|
|
|
|
void property_handlers_init();
|
|
|
|
|
|
2009-04-07 19:02:07 +02:00
|
|
|
|
/**
|
2009-06-29 21:54:51 +02:00
|
|
|
|
* There was a key press. We compare this key code with our bindings table and
|
|
|
|
|
* pass the bound action to parse_command().
|
2009-04-07 19:02:07 +02:00
|
|
|
|
*
|
|
|
|
|
*/
|
2009-06-29 21:54:51 +02:00
|
|
|
|
int handle_key_press(void *ignored, xcb_connection_t *conn,
|
|
|
|
|
xcb_key_press_event_t *event);
|
2009-04-07 19:02:07 +02:00
|
|
|
|
|
|
|
|
|
/**
|
2009-06-29 21:54:51 +02:00
|
|
|
|
* When the user moves the mouse pointer onto a window, this callback gets
|
|
|
|
|
* called.
|
2009-04-07 19:02:07 +02:00
|
|
|
|
*
|
|
|
|
|
*/
|
2009-06-29 21:54:51 +02:00
|
|
|
|
int handle_enter_notify(void *ignored, xcb_connection_t *conn,
|
|
|
|
|
xcb_enter_notify_event_t *event);
|
2009-04-07 19:02:07 +02:00
|
|
|
|
|
2009-08-06 00:59:48 +02:00
|
|
|
|
/**
|
|
|
|
|
* When the user moves the mouse but does not change the active window
|
|
|
|
|
* (e.g. when having no windows opened but moving mouse on the root screen
|
|
|
|
|
* and crossing virtual screen boundaries), this callback gets called.
|
|
|
|
|
*
|
|
|
|
|
*/
|
|
|
|
|
int handle_motion_notify(void *ignored, xcb_connection_t *conn,
|
|
|
|
|
xcb_motion_notify_event_t *event);
|
|
|
|
|
|
2009-08-07 15:35:12 +02:00
|
|
|
|
/**
|
|
|
|
|
* Called when the keyboard mapping changes (for example by using Xmodmap),
|
|
|
|
|
* we need to update our key bindings then (re-translate symbols).
|
|
|
|
|
*
|
|
|
|
|
*/
|
|
|
|
|
int handle_mapping_notify(void *ignored, xcb_connection_t *conn,
|
|
|
|
|
xcb_mapping_notify_event_t *event);
|
2011-03-14 17:20:04 +01:00
|
|
|
|
#if 0
|
2009-08-07 15:35:12 +02:00
|
|
|
|
|
2009-04-07 19:02:07 +02:00
|
|
|
|
/**
|
2009-06-29 21:54:51 +02:00
|
|
|
|
* Checks if the button press was on a stack window, handles focus setting and
|
|
|
|
|
* returns true if so, or false otherwise.
|
2009-04-07 19:02:07 +02:00
|
|
|
|
*
|
|
|
|
|
*/
|
2009-06-29 21:54:51 +02:00
|
|
|
|
int handle_button_press(void *ignored, xcb_connection_t *conn,
|
|
|
|
|
xcb_button_press_event_t *event);
|
2010-04-13 19:33:40 +02:00
|
|
|
|
#endif
|
2009-04-07 19:02:07 +02:00
|
|
|
|
/**
|
|
|
|
|
* A new window appeared on the screen (=was mapped), so let’s manage it.
|
|
|
|
|
*
|
|
|
|
|
*/
|
2009-06-29 21:54:51 +02:00
|
|
|
|
int handle_map_request(void *prophs, xcb_connection_t *conn,
|
|
|
|
|
xcb_map_request_event_t *event);
|
2010-04-13 19:33:40 +02:00
|
|
|
|
#if 0
|
2009-04-07 19:02:07 +02:00
|
|
|
|
/**
|
2009-06-29 21:54:51 +02:00
|
|
|
|
* Configuration notifies are only handled because we need to set up ignore
|
|
|
|
|
* for the following enter notify events
|
2009-04-07 19:02:07 +02:00
|
|
|
|
*
|
|
|
|
|
*/
|
2009-02-28 22:11:48 +01:00
|
|
|
|
int handle_configure_event(void *prophs, xcb_connection_t *conn, xcb_configure_notify_event_t *event);
|
2011-01-05 00:16:10 +01:00
|
|
|
|
#endif
|
2009-04-07 19:02:07 +02:00
|
|
|
|
|
2010-03-02 12:47:21 +01:00
|
|
|
|
/**
|
|
|
|
|
* Gets triggered upon a RandR screen change event, that is when the user
|
|
|
|
|
* changes the screen configuration in any way (mode, position, …)
|
|
|
|
|
*
|
|
|
|
|
*/
|
|
|
|
|
int handle_screen_change(void *prophs, xcb_connection_t *conn,
|
|
|
|
|
xcb_generic_event_t *e);
|
|
|
|
|
|
2009-04-07 19:02:07 +02:00
|
|
|
|
/**
|
2009-06-29 21:54:51 +02:00
|
|
|
|
* Configure requests are received when the application wants to resize
|
|
|
|
|
* windows on their own.
|
2009-04-07 19:02:07 +02:00
|
|
|
|
*
|
2009-06-29 21:54:51 +02:00
|
|
|
|
* We generate a synthethic configure notify event to signalize the client its
|
|
|
|
|
* "new" position.
|
2009-04-07 19:02:07 +02:00
|
|
|
|
*
|
|
|
|
|
*/
|
2009-06-29 21:54:51 +02:00
|
|
|
|
int handle_configure_request(void *prophs, xcb_connection_t *conn,
|
|
|
|
|
xcb_configure_request_event_t *event);
|
2010-11-12 21:41:10 +01:00
|
|
|
|
|
2009-04-07 19:02:07 +02:00
|
|
|
|
/**
|
2009-06-29 21:54:51 +02:00
|
|
|
|
* Our window decorations were unmapped. That means, the window will be killed
|
|
|
|
|
* now, so we better clean up before.
|
2009-04-07 19:02:07 +02:00
|
|
|
|
*
|
|
|
|
|
*/
|
2009-03-10 00:51:15 +01:00
|
|
|
|
int handle_unmap_notify_event(void *data, xcb_connection_t *conn, xcb_unmap_notify_event_t *event);
|
2010-04-17 17:27:53 +02:00
|
|
|
|
|
2010-03-24 16:52:16 +01:00
|
|
|
|
/**
|
|
|
|
|
* A destroy notify event is sent when the window is not unmapped, but
|
|
|
|
|
* immediately destroyed (for example when starting a window and immediately
|
|
|
|
|
* killing the program which started it).
|
|
|
|
|
*
|
|
|
|
|
* We just pass on the event to the unmap notify handler (by copying the
|
|
|
|
|
* important fields in the event data structure).
|
|
|
|
|
*
|
|
|
|
|
*/
|
|
|
|
|
int handle_destroy_notify_event(void *data, xcb_connection_t *conn,
|
|
|
|
|
xcb_destroy_notify_event_t *event);
|
|
|
|
|
|
2009-04-07 19:02:07 +02:00
|
|
|
|
/**
|
|
|
|
|
* Called when a window changes its title
|
|
|
|
|
*
|
|
|
|
|
*/
|
2009-02-13 19:04:45 +01:00
|
|
|
|
int handle_windowname_change(void *data, xcb_connection_t *conn, uint8_t state,
|
2009-06-29 21:54:51 +02:00
|
|
|
|
xcb_window_t window, xcb_atom_t atom,
|
|
|
|
|
xcb_get_property_reply_t *prop);
|
2009-04-07 19:02:07 +02:00
|
|
|
|
/**
|
2010-04-13 17:46:54 +02:00
|
|
|
|
* Handles legacy window name updates (WM_NAME), see also src/window.c,
|
|
|
|
|
* window_update_name_legacy().
|
2009-04-07 19:02:07 +02:00
|
|
|
|
*
|
|
|
|
|
*/
|
2009-06-29 21:54:51 +02:00
|
|
|
|
int handle_windowname_change_legacy(void *data, xcb_connection_t *conn,
|
|
|
|
|
uint8_t state, xcb_window_t window,
|
|
|
|
|
xcb_atom_t atom, xcb_get_property_reply_t
|
|
|
|
|
*prop);
|
2009-03-30 09:39:35 +02:00
|
|
|
|
|
2010-04-13 17:46:54 +02:00
|
|
|
|
#if 0
|
2009-03-30 09:39:35 +02:00
|
|
|
|
/**
|
|
|
|
|
* Store the window classes for jumping to them later.
|
|
|
|
|
*
|
|
|
|
|
*/
|
|
|
|
|
int handle_windowclass_change(void *data, xcb_connection_t *conn, uint8_t state,
|
2009-06-29 21:54:51 +02:00
|
|
|
|
xcb_window_t window, xcb_atom_t atom,
|
|
|
|
|
xcb_get_property_reply_t *prop);
|
2009-03-30 09:39:35 +02:00
|
|
|
|
|
2010-04-13 19:33:40 +02:00
|
|
|
|
#endif
|
2009-04-07 19:02:07 +02:00
|
|
|
|
/**
|
|
|
|
|
* Expose event means we should redraw our windows (= title bar)
|
|
|
|
|
*
|
|
|
|
|
*/
|
2009-06-29 21:54:51 +02:00
|
|
|
|
int handle_expose_event(void *data, xcb_connection_t *conn,
|
|
|
|
|
xcb_expose_event_t *event);
|
2009-04-07 19:02:07 +02:00
|
|
|
|
/**
|
|
|
|
|
* Handle client messages (EWMH)
|
|
|
|
|
*
|
|
|
|
|
*/
|
2009-06-29 21:54:51 +02:00
|
|
|
|
int handle_client_message(void *data, xcb_connection_t *conn,
|
|
|
|
|
xcb_client_message_event_t *event);
|
2009-04-07 19:02:07 +02:00
|
|
|
|
|
2010-04-17 13:54:45 +02:00
|
|
|
|
#if 0
|
2009-04-07 19:02:07 +02:00
|
|
|
|
/**
|
|
|
|
|
* Handles _NET_WM_WINDOW_TYPE changes
|
|
|
|
|
*
|
|
|
|
|
*/
|
2009-06-29 21:54:51 +02:00
|
|
|
|
int handle_window_type(void *data, xcb_connection_t *conn, uint8_t state,
|
|
|
|
|
xcb_window_t window, xcb_atom_t atom,
|
|
|
|
|
xcb_get_property_reply_t *property);
|
2010-10-11 21:32:04 +02:00
|
|
|
|
#endif
|
2009-04-07 19:02:07 +02:00
|
|
|
|
|
|
|
|
|
/**
|
2009-06-29 21:54:51 +02:00
|
|
|
|
* Handles the size hints set by a window, but currently only the part
|
|
|
|
|
* necessary for displaying clients proportionally inside their frames
|
|
|
|
|
* (mplayer for example)
|
2009-04-07 19:02:07 +02:00
|
|
|
|
*
|
|
|
|
|
* See ICCCM 4.1.2.3 for more details
|
|
|
|
|
*
|
|
|
|
|
*/
|
2009-06-29 21:54:51 +02:00
|
|
|
|
int handle_normal_hints(void *data, xcb_connection_t *conn, uint8_t state,
|
|
|
|
|
xcb_window_t window, xcb_atom_t name,
|
|
|
|
|
xcb_get_property_reply_t *reply);
|
2009-02-13 19:04:45 +01:00
|
|
|
|
|
2009-09-06 22:40:11 +02:00
|
|
|
|
/**
|
|
|
|
|
* Handles the WM_HINTS property for extracting the urgency state of the window.
|
|
|
|
|
*
|
|
|
|
|
*/
|
|
|
|
|
int handle_hints(void *data, xcb_connection_t *conn, uint8_t state, xcb_window_t window,
|
|
|
|
|
xcb_atom_t name, xcb_get_property_reply_t *reply);
|
|
|
|
|
|
2009-06-12 22:59:23 +02:00
|
|
|
|
/**
|
2009-06-29 21:54:51 +02:00
|
|
|
|
* Handles the transient for hints set by a window, signalizing that this
|
|
|
|
|
* window is a popup window for some other window.
|
2009-06-12 22:59:23 +02:00
|
|
|
|
*
|
|
|
|
|
* See ICCCM 4.1.2.6 for more details
|
|
|
|
|
*
|
|
|
|
|
*/
|
2009-06-29 21:54:51 +02:00
|
|
|
|
int handle_transient_for(void *data, xcb_connection_t *conn, uint8_t state,
|
|
|
|
|
xcb_window_t window, xcb_atom_t name,
|
|
|
|
|
xcb_get_property_reply_t *reply);
|
2009-06-12 22:59:23 +02:00
|
|
|
|
|
2009-08-05 00:39:55 +02:00
|
|
|
|
/**
|
|
|
|
|
* Handles changes of the WM_CLIENT_LEADER atom which specifies if this is a
|
|
|
|
|
* toolwindow (or similar) and to which window it belongs (logical parent).
|
|
|
|
|
*
|
|
|
|
|
*/
|
|
|
|
|
int handle_clientleader_change(void *data, xcb_connection_t *conn,
|
|
|
|
|
uint8_t state, xcb_window_t window,
|
|
|
|
|
xcb_atom_t name, xcb_get_property_reply_t *prop);
|
|
|
|
|
|
2011-03-20 16:26:36 +01:00
|
|
|
|
int handle_focus_in(void *data, xcb_connection_t *conn, xcb_focus_in_event_t *event);
|
2009-02-13 19:04:45 +01:00
|
|
|
|
#endif
|