4 * i3 - an improved dynamic tiling window manager
6 * © 2009 Michael Stapelberg and contributors
8 * See file LICENSE for license information.
14 /** Callback for dragging */
15 typedef void(*callback_t)(Rect*, uint32_t, uint32_t);
17 /** On which border was the dragging initiated? */
18 typedef enum { BORDER_LEFT, BORDER_RIGHT, BORDER_TOP, BORDER_BOTTOM} border_t;
21 * Enters floating mode for the given client. Correctly takes care of the
22 * position/size (separately stored for tiling/floating mode) and
23 * repositions/resizes/redecorates the client.
25 * If the automatic flag is set to true, this was an automatic update by a
26 * change of the window class from the application which can be overwritten by
30 void toggle_floating_mode(xcb_connection_t *conn, Client *client,
34 * Removes the floating client from its workspace and attaches it to the new
35 * workspace. This is centralized here because it may happen if you move it
36 * via keyboard and if you move it using your mouse.
39 void floating_assign_to_workspace(Client *client, Workspace *new_workspace);
42 * Called whenever the user clicks on a border (not the titlebar!) of a
43 * floating window. Determines on which border the user clicked and launches
44 * the drag_pointer function with the resize_callback.
47 int floating_border_click(xcb_connection_t *conn, Client *client,
48 xcb_button_press_event_t *event);
51 * Called when the user clicked on the titlebar of a floating window.
52 * Calls the drag_pointer function with the drag_window callback
55 void floating_drag_window(xcb_connection_t *conn, Client *client,
56 xcb_button_press_event_t *event);
59 * Called when the user right-clicked on the titlebar of a floating window to
61 * Calls the drag_pointer function with the resize_window callback
64 void floating_resize_window(xcb_connection_t *conn, Client *client,
65 xcb_button_press_event_t *event);
68 * Changes focus in the given direction for floating clients.
70 * Changing to the left/right means going to the previous/next floating client,
71 * changing to top/bottom means cycling through the Z-index.
74 void floating_focus_direction(xcb_connection_t *conn, Client *currently_focused,
75 direction_t direction);
78 * Moves the client 10px to the specified direction.
81 void floating_move(xcb_connection_t *conn, Client *currently_focused,
82 direction_t direction);
85 * Hides all floating clients (or show them if they are currently hidden) on
86 * the specified workspace.
89 void floating_toggle_hide(xcb_connection_t *conn, Workspace *workspace);
92 * This function grabs your pointer and lets you drag stuff around (borders).
93 * Every time you move your mouse, an XCB_MOTION_NOTIFY event will be received
94 * and the given callback will be called with the parameters specified (client,
95 * border on which the click originally was), the original rect of the client,
96 * the event and the new coordinates (x, y).
99 void drag_pointer(xcb_connection_t *conn, Client *client, xcb_button_press_event_t *event,
100 xcb_window_t confine_to, border_t border, callback_t callback);