4 * i3 - an improved dynamic tiling window manager
6 * © 2009-2010 Michael Stapelberg and contributors
8 * See file LICENSE for license information.
16 /** Callback for dragging */
17 typedef void(*callback_t)(Con*, Rect*, uint32_t, uint32_t, void*);
19 /** Macro to create a callback function for dragging */
20 #define DRAGGING_CB(name) \
21 static void name(Con *con, Rect *old_rect, uint32_t new_x, \
22 uint32_t new_y, void *extra)
24 /** On which border was the dragging initiated? */
25 typedef enum { BORDER_LEFT = (1 << 0),
26 BORDER_RIGHT = (1 << 1),
27 BORDER_TOP = (1 << 2),
28 BORDER_BOTTOM = (1 << 3)} border_t;
31 * Enables floating mode for the given container by detaching it from its
32 * parent, creating a new container around it and storing this container in the
33 * floating_windows list of the workspace.
36 void floating_enable(Con *con, bool automatic);
39 * Disables floating mode for the given container by re-attaching the container
43 void floating_disable(Con *con, bool automatic);
46 * Calls floating_enable() for tiling containers and floating_disable() for
47 * floating containers.
49 * If the automatic flag is set to true, this was an automatic update by a
50 * change of the window class from the application which can be overwritten by
54 void toggle_floating_mode(Con *con, bool automatic);
57 * Raises the given container in the list of floating containers
60 void floating_raise_con(Con *con);
63 * Checks if con’s coordinates are within its workspace and re-assigns it to
64 * the actual workspace if not.
67 bool floating_maybe_reassign_ws(Con *con);
71 * Removes the floating client from its workspace and attaches it to the new
72 * workspace. This is centralized here because it may happen if you move it
73 * via keyboard and if you move it using your mouse.
76 void floating_assign_to_workspace(Client *client, Workspace *new_workspace);
79 * Called whenever the user clicks on a border (not the titlebar!) of a
80 * floating window. Determines on which border the user clicked and launches
81 * the drag_pointer function with the resize_callback.
84 int floating_border_click(xcb_connection_t *conn, Client *client,
85 xcb_button_press_event_t *event);
89 * Called when the user clicked on the titlebar of a floating window.
90 * Calls the drag_pointer function with the drag_window callback
93 void floating_drag_window(Con *con, xcb_button_press_event_t *event);
96 * Called when the user clicked on a floating window while holding the
97 * floating_modifier and the right mouse button.
98 * Calls the drag_pointer function with the resize_window callback
101 void floating_resize_window(Con *con, bool proportional, xcb_button_press_event_t *event);
105 * Changes focus in the given direction for floating clients.
107 * Changing to the left/right means going to the previous/next floating client,
108 * changing to top/bottom means cycling through the Z-index.
111 void floating_focus_direction(xcb_connection_t *conn, Client *currently_focused,
112 direction_t direction);
115 * Moves the client 10px to the specified direction.
118 void floating_move(xcb_connection_t *conn, Client *currently_focused,
119 direction_t direction);
122 * Hides all floating clients (or show them if they are currently hidden) on
123 * the specified workspace.
126 void floating_toggle_hide(xcb_connection_t *conn, Workspace *workspace);
130 * This function grabs your pointer and lets you drag stuff around (borders).
131 * Every time you move your mouse, an XCB_MOTION_NOTIFY event will be received
132 * and the given callback will be called with the parameters specified (client,
133 * border on which the click originally was), the original rect of the client,
134 * the event and the new coordinates (x, y).
137 void drag_pointer(Con *con, xcb_button_press_event_t *event,
138 xcb_window_t confine_to, border_t border, callback_t callback,