]> git.sur5r.net Git - i3/i3/blob - include/client.h
updated doxygen docu, added FIXMEs, fixed headers to 80chars width.
[i3/i3] / include / client.h
1 /*
2  * vim:ts=8:expandtab
3  *
4  * i3 - an improved dynamic tiling window manager
5  *
6  * (c) 2009 Michael Stapelberg and contributors
7  *
8  * See file LICENSE for license information.
9  *
10  */
11 #include <xcb/xcb.h>
12
13 #include "data.h"
14
15 #ifndef _CLIENT_H
16 #define _CLIENT_H
17
18 /**
19  * Removes the given client from the container, either because it will be
20  * inserted into another one or because it was unmapped
21  *
22  */
23 void client_remove_from_container(xcb_connection_t *conn, Client *client,
24                                   Container *container,
25                                   bool remove_from_focusstack);
26
27 /**
28  * Warps the pointer into the given client (in the middle of it, to be
29  * specific), therefore selecting it
30  *
31  */
32 void client_warp_pointer_into(xcb_connection_t *conn, Client *client);
33
34 /**
35  * Kills the given window using WM_DELETE_WINDOW or xcb_kill_window
36  *
37  */
38 void client_kill(xcb_connection_t *conn, Client *window);
39
40 /**
41  * Checks if the given window class and title match the given client Window
42  * title is passed as "normal" string and as UCS-2 converted string for
43  * matching _NET_WM_NAME capable clients as well as those using legacy hints.
44  *
45  */
46 bool client_matches_class_name(Client *client, char *to_class, char *to_title,
47                                char *to_title_ucs, int to_title_ucs_len);
48
49 /**
50  * Enters fullscreen mode for the given client. This is called by toggle_fullscreen
51  * and when moving a fullscreen client to another screen.
52  *
53  */
54 void client_enter_fullscreen(xcb_connection_t *conn, Client *client);
55
56 /**
57  * Toggles fullscreen mode for the given client. It updates the data
58  * structures and reconfigures (= resizes/moves) the client and its frame to
59  * the full size of the screen. When leaving fullscreen, re-rendering the
60  * layout is forced.
61  *
62  */
63 void client_toggle_fullscreen(xcb_connection_t *conn, Client *client);
64
65 /**
66  * Sets the position of the given client in the X stack to the highest (tiling
67  * layer is always on the same position, so this doesn’t matter) below the
68  * first floating client, so that floating windows are always on top.
69  *
70  */
71 void client_set_below_floating(xcb_connection_t *conn, Client *client);
72
73 /**
74  * Returns true if the client is floating. Makes the code more beatiful, as
75  * floating is not simply a boolean, but also saves whether the user selected
76  * the current state or whether it was automatically set.
77  *
78  */
79 bool client_is_floating(Client *client);
80
81 #endif