2009-07-28 07:55:09 -04:00
|
|
|
|
/*
|
2011-10-25 16:19:38 -04:00
|
|
|
|
* vim:ts=4:sw=4:expandtab
|
2009-07-28 07:55:09 -04:00
|
|
|
|
*
|
|
|
|
|
* i3 - an improved dynamic tiling window manager
|
2015-04-03 20:17:56 -04:00
|
|
|
|
* © 2009 Michael Stapelberg and contributors (see also: LICENSE)
|
2009-07-28 07:55:09 -04:00
|
|
|
|
*
|
2011-10-25 16:19:38 -04:00
|
|
|
|
* workspace.c: Modifying workspaces, accessing them, moving containers to
|
|
|
|
|
* workspaces.
|
2009-07-28 07:55:09 -04:00
|
|
|
|
*
|
|
|
|
|
*/
|
2013-12-28 21:11:50 -05:00
|
|
|
|
#pragma once
|
2009-07-28 07:55:09 -04:00
|
|
|
|
|
|
|
|
|
#include "data.h"
|
2010-03-27 10:25:51 -04:00
|
|
|
|
#include "tree.h"
|
2010-03-02 06:47:21 -05:00
|
|
|
|
#include "randr.h"
|
2009-07-28 07:55:09 -04:00
|
|
|
|
|
Handle the EWMH atom _NET_WM_DESKTOP.
We already claim _NET_WM_DESKTOP support in _NET_SUPPORTED since around 2009,
but haven't actually done anything with it. However, especially pagers like
gnome-panel rely on this property to be updated and many tools, like GTK, want
to use the corresponding client messages to make a window sticky, move it
around etc.
This patch implements full support according to the EWMH spec. This means:
* We set the property on all windows when managing it.
* We keep the property updated on all windows at all times.
* We read and respect the property upon managing a window if it was set before
mapping the window.
* We react to client messages for it.
* We remove the property on withdrawn windows.
Note that the special value 0xFFFFFFFF, according to the spec, means that the
window shall be shown on all workspaces. We do this by making it sticky and
float it. This shows it on all workspaces at least on the output it is on.
Furthermore, the spec gives us the freedom to ignore _NET_WM_DESKTOP when
managing a window if we have good reason to. In our case, we give window
swallowing a higher priority since the user would likely expect that and we
want to keep placeholder windows only around for as long as we have to.
However, we do prioritize this property over, for example, startup
notifications.
fixes #2153
fixes #1507
fixes #938
2016-01-11 14:53:26 -05:00
|
|
|
|
/* We use NET_WM_DESKTOP_NONE for cases where we cannot determine the EWMH
|
|
|
|
|
* desktop index for a window. We cannot use a negative value like -1 since we
|
|
|
|
|
* need to use uint32_t as we actually need the full range of it. This is
|
|
|
|
|
* technically dangerous, but it's safe to assume that we will never have more
|
|
|
|
|
* than 4294967279 workspaces open at a time. */
|
|
|
|
|
#define NET_WM_DESKTOP_NONE 0xFFFFFFF0
|
|
|
|
|
#define NET_WM_DESKTOP_ALL 0xFFFFFFFF
|
|
|
|
|
|
2009-09-27 09:20:47 -04:00
|
|
|
|
/**
|
|
|
|
|
* Returns a pointer to the workspace with the given number (starting at 0),
|
|
|
|
|
* creating the workspace if necessary (by allocating the necessary amount of
|
|
|
|
|
* memory and initializing the data structures correctly).
|
|
|
|
|
*
|
2011-03-13 19:56:04 -04:00
|
|
|
|
* If created is not NULL, *created will be set to whether or not the
|
|
|
|
|
* workspace has just been created.
|
|
|
|
|
*
|
2009-09-27 09:20:47 -04:00
|
|
|
|
*/
|
2011-03-13 19:56:04 -04:00
|
|
|
|
Con *workspace_get(const char *num, bool *created);
|
2009-09-27 08:00:54 -04:00
|
|
|
|
|
2015-09-14 03:28:42 -04:00
|
|
|
|
/**
|
|
|
|
|
* Extracts workspace names from keybindings (e.g. “web” from “bindsym $mod+1
|
|
|
|
|
* workspace web”), so that when an output needs a workspace, i3 can start with
|
|
|
|
|
* the first configured one. Needs to be called before reorder_bindings() so
|
|
|
|
|
* that the config-file order is used, not the i3-internal order.
|
|
|
|
|
*
|
|
|
|
|
*/
|
|
|
|
|
void extract_workspace_names_from_bindings(void);
|
|
|
|
|
|
|
|
|
|
/**
|
2012-01-14 17:09:09 -05:00
|
|
|
|
* Returns a pointer to a new workspace in the given output. The workspace
|
|
|
|
|
* is created attached to the tree hierarchy through the given content
|
|
|
|
|
* container.
|
|
|
|
|
*
|
|
|
|
|
*/
|
|
|
|
|
Con *create_workspace_on_output(Output *output, Con *content);
|
|
|
|
|
|
2010-03-27 10:25:51 -04:00
|
|
|
|
#if 0
|
2009-07-28 07:55:09 -04:00
|
|
|
|
/**
|
|
|
|
|
* Sets the name (or just its number) for the given workspace. This has to
|
|
|
|
|
* be called for every workspace as the rendering function
|
|
|
|
|
* (render_internal_bar) relies on workspace->name and workspace->name_len
|
|
|
|
|
* being ready-to-use.
|
|
|
|
|
*
|
|
|
|
|
*/
|
|
|
|
|
void workspace_set_name(Workspace *ws, const char *name);
|
2010-11-12 11:34:13 -05:00
|
|
|
|
#endif
|
2009-07-28 07:55:09 -04:00
|
|
|
|
|
2009-08-02 16:31:52 -04:00
|
|
|
|
/**
|
|
|
|
|
* Returns true if the workspace is currently visible. Especially important for
|
|
|
|
|
* multi-monitor environments, as they can have multiple currenlty active
|
|
|
|
|
* workspaces.
|
|
|
|
|
*
|
|
|
|
|
*/
|
2010-11-12 11:34:13 -05:00
|
|
|
|
bool workspace_is_visible(Con *ws);
|
2009-08-02 16:31:52 -04:00
|
|
|
|
|
2011-10-02 17:03:16 -04:00
|
|
|
|
/**
|
|
|
|
|
* Switches to the given workspace
|
|
|
|
|
*
|
|
|
|
|
*/
|
2011-10-02 11:54:23 -04:00
|
|
|
|
void workspace_show(Con *ws);
|
2011-10-02 17:03:16 -04:00
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Looks up the workspace by name and switches to it.
|
|
|
|
|
*
|
|
|
|
|
*/
|
2011-10-02 11:54:23 -04:00
|
|
|
|
void workspace_show_by_name(const char *num);
|
2009-08-08 13:51:51 -04:00
|
|
|
|
|
2011-06-10 10:03:59 -04:00
|
|
|
|
/**
|
2011-10-02 11:54:23 -04:00
|
|
|
|
* Returns the next workspace.
|
2011-06-10 10:03:59 -04:00
|
|
|
|
*
|
|
|
|
|
*/
|
2014-06-19 05:20:32 -04:00
|
|
|
|
Con *workspace_next(void);
|
2011-06-10 10:03:59 -04:00
|
|
|
|
|
|
|
|
|
/**
|
2011-10-02 11:54:23 -04:00
|
|
|
|
* Returns the previous workspace.
|
2011-06-10 10:03:59 -04:00
|
|
|
|
*
|
|
|
|
|
*/
|
2014-06-19 05:20:32 -04:00
|
|
|
|
Con *workspace_prev(void);
|
2011-06-10 10:03:59 -04:00
|
|
|
|
|
2011-12-24 21:30:10 -05:00
|
|
|
|
/**
|
|
|
|
|
* Returns the next workspace on the same output
|
|
|
|
|
*
|
|
|
|
|
*/
|
2014-06-19 05:20:32 -04:00
|
|
|
|
Con *workspace_next_on_output(void);
|
2011-12-24 21:30:10 -05:00
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Returns the previous workspace on the same output
|
|
|
|
|
*
|
|
|
|
|
*/
|
2014-06-19 05:20:32 -04:00
|
|
|
|
Con *workspace_prev_on_output(void);
|
2011-12-24 21:30:10 -05:00
|
|
|
|
|
2011-10-17 18:17:56 -04:00
|
|
|
|
/**
|
|
|
|
|
* Focuses the previously focused workspace.
|
|
|
|
|
*
|
|
|
|
|
*/
|
2012-03-31 04:53:04 -04:00
|
|
|
|
void workspace_back_and_forth(void);
|
2011-10-17 18:17:56 -04:00
|
|
|
|
|
2012-09-04 04:51:18 -04:00
|
|
|
|
/**
|
|
|
|
|
* Returns the previously focused workspace con, or NULL if unavailable.
|
|
|
|
|
*
|
|
|
|
|
*/
|
|
|
|
|
Con *workspace_back_and_forth_get(void);
|
|
|
|
|
|
2010-03-27 10:25:51 -04:00
|
|
|
|
#if 0
|
2009-12-21 16:30:08 -05:00
|
|
|
|
/**
|
|
|
|
|
* Assigns the given workspace to the given screen by correctly updating its
|
|
|
|
|
* state and reconfiguring all the clients on this workspace.
|
|
|
|
|
*
|
|
|
|
|
* This is called when initializing a screen and when re-assigning it to a
|
|
|
|
|
* different screen which just got available (if you configured it to be on
|
|
|
|
|
* screen 1 and you just plugged in screen 1).
|
|
|
|
|
*
|
|
|
|
|
*/
|
2010-03-05 09:22:12 -05:00
|
|
|
|
void workspace_assign_to(Workspace *ws, Output *screen, bool hide_it);
|
2009-12-21 16:30:08 -05:00
|
|
|
|
|
2009-08-08 13:51:51 -04:00
|
|
|
|
/**
|
|
|
|
|
* Initializes the given workspace if it is not already initialized. The given
|
|
|
|
|
* screen is to be understood as a fallback, if the workspace itself either
|
|
|
|
|
* was not assigned to a particular screen or cannot be placed there because
|
|
|
|
|
* the screen is not attached at the moment.
|
|
|
|
|
*
|
|
|
|
|
*/
|
2010-03-02 06:47:21 -05:00
|
|
|
|
void workspace_initialize(Workspace *ws, Output *screen, bool recheck);
|
2009-08-08 13:51:51 -04:00
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Gets the first unused workspace for the given screen, taking into account
|
|
|
|
|
* the preferred_screen setting of every workspace (workspace assignments).
|
|
|
|
|
*
|
|
|
|
|
*/
|
2010-03-05 10:18:41 -05:00
|
|
|
|
Workspace *get_first_workspace_for_output(Output *screen);
|
2009-08-08 13:51:51 -04:00
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Unmaps all clients (and stack windows) of the given workspace.
|
|
|
|
|
*
|
|
|
|
|
* This needs to be called separately when temporarily rendering a workspace
|
|
|
|
|
* which is not the active workspace to force reconfiguration of all clients,
|
|
|
|
|
* like in src/xinerama.c when re-assigning a workspace to another screen.
|
|
|
|
|
*
|
|
|
|
|
*/
|
|
|
|
|
void workspace_unmap_clients(xcb_connection_t *conn, Workspace *u_ws);
|
|
|
|
|
|
2009-09-06 16:40:11 -04:00
|
|
|
|
/**
|
|
|
|
|
* Maps all clients (and stack windows) of the given workspace.
|
|
|
|
|
*
|
|
|
|
|
*/
|
2009-08-08 13:51:51 -04:00
|
|
|
|
void workspace_map_clients(xcb_connection_t *conn, Workspace *ws);
|
2010-06-02 11:51:58 -04:00
|
|
|
|
#endif
|
2009-08-08 13:51:51 -04:00
|
|
|
|
|
2009-09-06 16:40:11 -04:00
|
|
|
|
/**
|
|
|
|
|
* Goes through all clients on the given workspace and updates the workspace’s
|
|
|
|
|
* urgent flag accordingly.
|
|
|
|
|
*
|
|
|
|
|
*/
|
2010-06-02 11:51:58 -04:00
|
|
|
|
void workspace_update_urgent_flag(Con *ws);
|
2009-09-06 16:40:11 -04:00
|
|
|
|
|
2011-02-14 17:17:30 -05:00
|
|
|
|
/**
|
|
|
|
|
* 'Forces' workspace orientation by moving all cons into a new split-con with
|
|
|
|
|
* the same orientation as the workspace and then changing the workspace
|
|
|
|
|
* orientation.
|
|
|
|
|
*
|
|
|
|
|
*/
|
2011-02-14 17:05:20 -05:00
|
|
|
|
void ws_force_orientation(Con *ws, orientation_t orientation);
|
|
|
|
|
|
2011-06-02 11:21:38 -04:00
|
|
|
|
/**
|
|
|
|
|
* Called when a new con (with a window, not an empty or split con) should be
|
|
|
|
|
* attached to the workspace (for example when managing a new window or when
|
|
|
|
|
* moving an existing window to the workspace level).
|
|
|
|
|
*
|
|
|
|
|
* Depending on the workspace_layout setting, this function either returns the
|
|
|
|
|
* workspace itself (default layout) or creates a new stacked/tabbed con and
|
|
|
|
|
* returns that.
|
|
|
|
|
*
|
|
|
|
|
*/
|
|
|
|
|
Con *workspace_attach_to(Con *ws);
|
|
|
|
|
|
2012-09-28 13:54:24 -04:00
|
|
|
|
/**
|
|
|
|
|
* Creates a new container and re-parents all of children from the given
|
|
|
|
|
* workspace into it.
|
|
|
|
|
*
|
|
|
|
|
* The container inherits the layout from the workspace.
|
|
|
|
|
*/
|
|
|
|
|
Con *workspace_encapsulate(Con *ws);
|
2015-03-04 03:22:25 -05:00
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* Move the given workspace to the specified output.
|
|
|
|
|
* This returns true if and only if moving the workspace was successful.
|
|
|
|
|
*
|
|
|
|
|
*/
|
2015-09-27 17:42:58 -04:00
|
|
|
|
bool workspace_move_to_output(Con *ws, const char *output);
|