#include "all.h"
#include "atoms_NET_SUPPORTED.xmacro"

Include dependency graph for ewmh.c:

Macros
#define	I3__FILE__ "ewmh.c"

#define	xmacro(atom) A_##atom,

Functions
void	ewmh_update_current_desktop (void)
	Updates _NET_CURRENT_DESKTOP with the current desktop number. More...

void	ewmh_update_number_of_desktops (void)
	Updates _NET_NUMBER_OF_DESKTOPS which we interpret as the number of noninternal workspaces. More...

void	ewmh_update_desktop_names (void)
	Updates _NET_DESKTOP_NAMES: "The names of all virtual desktops. More...

void	ewmh_update_desktop_viewport (void)
	Updates _NET_DESKTOP_VIEWPORT, which is an array of pairs of cardinals that define the top left corner of each desktop's viewport. More...

static void	ewmh_update_wm_desktop_recursively (Con *con, const uint32_t desktop)

void	ewmh_update_wm_desktop (void)
	Updates _NET_WM_DESKTOP for all windows. More...

void	ewmh_update_active_window (xcb_window_t window)
	Updates _NET_ACTIVE_WINDOW with the currently focused window. More...

void	ewmh_update_visible_name (xcb_window_t window, const char *name)
	Updates _NET_WM_VISIBLE_NAME. More...

void	ewmh_update_workarea (void)
	i3 currently does not support _NET_WORKAREA, because it does not correspond to i3’s concept of workspaces. More...

void	ewmh_update_client_list (xcb_window_t *list, int num_windows)
	Updates the _NET_CLIENT_LIST hint. More...

void	ewmh_update_client_list_stacking (xcb_window_t *stack, int num_windows)
	Updates the _NET_CLIENT_LIST_STACKING hint. More...

void	ewmh_update_sticky (xcb_window_t window, bool sticky)
	Set or remove _NET_WM_STATE_STICKY on the window. More...

void	ewmh_setup_hints (void)
	Set up the EWMH hints on the root window. More...

Con *	ewmh_get_workspace_by_index (uint32_t idx)
	Returns the workspace container as enumerated by the EWMH desktop model. More...

uint32_t	ewmh_get_workspace_index (Con *con)
	Returns the EWMH desktop index for the workspace the given container is on. More...

Variables
xcb_window_t	ewmh_window
	The EWMH support window that is used to indicate that an EWMH-compliant window manager is present. More...

Macro Definition Documentation

#define I3__FILE__ "ewmh.c"

Definition at line 2 of file ewmh.c.

#define xmacro ( atom ) A_##atom,

Function Documentation

Con* ewmh_get_workspace_by_index ( uint32_t idx )

Returns the workspace container as enumerated by the EWMH desktop model.

Returns NULL if no workspace could be found for the index.

This is the reverse of ewmh_get_workspace_index.

Definition at line 330 of file ewmh.c.

References con_is_internal(), croot, NET_WM_DESKTOP_NONE, output_get_content(), and TAILQ_FOREACH.

Referenced by handle_client_message(), and manage_window().

Here is the call graph for this function:

uint32_t ewmh_get_workspace_index ( Con * con )

Returns the EWMH desktop index for the workspace the given container is on.

Returns NET_WM_DESKTOP_NONE if the desktop index cannot be determined.

This is the reverse of ewmh_get_workspace_by_index.

Definition at line 360 of file ewmh.c.

References con_get_workspace(), con_is_internal(), croot, NET_WM_DESKTOP_NONE, output_get_content(), and TAILQ_FOREACH.

Referenced by ewmh_update_current_desktop().

Here is the call graph for this function:

void ewmh_setup_hints ( void )

Set up the EWMH hints on the root window.

Definition at line 284 of file ewmh.c.

References conn, ewmh_window, root, XCB_ATOM_ATOM, and XCB_ATOM_WINDOW.

Referenced by main().

void ewmh_update_active_window ( xcb_window_t window )

Updates _NET_ACTIVE_WINDOW with the currently focused window.

EWMH: The window ID of the currently active window or None if no window has the focus.

Definition at line 198 of file ewmh.c.

References conn, root, and XCB_ATOM_WINDOW.

Referenced by x_push_changes().

void ewmh_update_client_list	(	xcb_window_t *	list,
		int	num_windows
	)

Updates the _NET_CLIENT_LIST hint.

Used for window listers.

Definition at line 238 of file ewmh.c.

References conn, root, and XCB_ATOM_WINDOW.

Referenced by x_push_changes().

void ewmh_update_client_list_stacking	(	xcb_window_t *	stack,
		int	num_windows
	)

Updates the _NET_CLIENT_LIST_STACKING hint.

Necessary to move tabs in Chromium correctly.

EWMH: These arrays contain all X Windows managed by the Window Manager. _NET_CLIENT_LIST has initial mapping order, starting with the oldest window. _NET_CLIENT_LIST_STACKING has bottom-to-top stacking order. These properties SHOULD be set and updated by the Window Manager.

Definition at line 254 of file ewmh.c.

References conn, root, and XCB_ATOM_WINDOW.

Referenced by x_push_changes().

void ewmh_update_current_desktop ( void )

Updates _NET_CURRENT_DESKTOP with the current desktop number.

EWMH: The index of the current desktop. This is always an integer between 0 and _NET_NUMBER_OF_DESKTOPS - 1.

Definition at line 23 of file ewmh.c.

References conn, ewmh_get_workspace_index(), focused, NET_WM_DESKTOP_NONE, root, and XCB_ATOM_CARDINAL.

Referenced by _workspace_show(), cmd_rename_workspace(), and main().

Here is the call graph for this function:

void ewmh_update_desktop_names ( void )

Updates _NET_DESKTOP_NAMES: "The names of all virtual desktops.

This is a list of NULL-terminated strings in UTF-8 encoding"

Definition at line 55 of file ewmh.c.

References conn, croot, Con::name, output_get_content(), root, STARTS_WITH, and TAILQ_FOREACH.

Referenced by _workspace_show(), cmd_rename_workspace(), main(), and workspace_get().

Here is the call graph for this function:

void ewmh_update_desktop_viewport ( void )

Updates _NET_DESKTOP_VIEWPORT, which is an array of pairs of cardinals that define the top left corner of each desktop's viewport.

Definition at line 93 of file ewmh.c.

References conn, croot, Con::name, output_get_content(), Con::rect, root, STARTS_WITH, TAILQ_FOREACH, Rect::x, XCB_ATOM_CARDINAL, and Rect::y.

Referenced by _workspace_show(), cmd_rename_workspace(), main(), and workspace_get().

Here is the call graph for this function:

void ewmh_update_number_of_desktops ( void )

Updates _NET_NUMBER_OF_DESKTOPS which we interpret as the number of noninternal workspaces.

Definition at line 34 of file ewmh.c.

References conn, croot, Con::name, output_get_content(), root, STARTS_WITH, TAILQ_FOREACH, and XCB_ATOM_CARDINAL.

Referenced by _workspace_show(), main(), and workspace_get().

Here is the call graph for this function:

void ewmh_update_sticky	(	xcb_window_t	window,
		bool	sticky
	)

Set or remove _NET_WM_STATE_STICKY on the window.

Definition at line 270 of file ewmh.c.

References conn, DLOG, xcb_add_property_atom(), and xcb_remove_property_atom().

Referenced by cmd_sticky(), and handle_client_message().

Here is the call graph for this function:

void ewmh_update_visible_name	(	xcb_window_t	window,
		const char *	name
	)

Updates _NET_WM_VISIBLE_NAME.

Definition at line 207 of file ewmh.c.

References conn.

Referenced by cmd_title_format(), window_update_name(), and window_update_name_legacy().

void ewmh_update_wm_desktop ( void )

Updates _NET_WM_DESKTOP for all windows.

A request will only be made if the cached value differs from the calculated value.

Definition at line 175 of file ewmh.c.

References con_is_internal(), croot, ewmh_update_wm_desktop_recursively(), output_get_content(), and TAILQ_FOREACH.

Referenced by _con_move_to_con(), _workspace_show(), cmd_sticky(), handle_client_message(), manage_window(), tree_move(), and workspace_get().

Here is the call graph for this function:

static void ewmh_update_wm_desktop_recursively	(	Con *	con,
		const uint32_t	desktop
	)

static

Definition at line 126 of file ewmh.c.

References con_has_managed_window(), con_is_floating(), con_is_sticky(), conn, DLOG, ELOG, Window::id, NET_WM_DESKTOP_ALL, NET_WM_DESKTOP_NONE, TAILQ_FOREACH, Con::type, Con::window, Window::wm_desktop, and XCB_ATOM_CARDINAL.

Referenced by ewmh_update_wm_desktop().

Here is the call graph for this function:

void ewmh_update_workarea ( void )

i3 currently does not support _NET_WORKAREA, because it does not correspond to i3’s concept of workspaces.

We need to actively delete this property because some display managers (e.g. LightDM) set it.

EWMH: Contains a geometry for each desktop. These geometries specify an area that is completely contained within the viewport. Work area SHOULD be used by desktop applications to place desktop icons appropriately.

Definition at line 230 of file ewmh.c.

References conn, and root.

Referenced by main().

Variable Documentation

xcb_window_t ewmh_window

The EWMH support window that is used to indicate that an EWMH-compliant window manager is present.

This window is created when i3 starts and kept alive until i3 exits. We also use this window as the focused window if no other window is available to be focused on the active workspace in order to prevent keyboard focus issues (see #1378).

Definition at line 14 of file ewmh.c.

Referenced by ewmh_setup_hints(), and x_push_changes().

Macros

Functions

Variables

Macro Definition Documentation

Function Documentation

Variable Documentation