162 lines
4.6 KiB
C
162 lines
4.6 KiB
C
/*
|
||
* vim:ts=8:expandtab
|
||
*
|
||
* i3 - an improved dynamic tiling window manager
|
||
*
|
||
* © 2009 Michael Stapelberg and contributors
|
||
*
|
||
* See file LICENSE for license information.
|
||
*
|
||
*/
|
||
#include <xcb/xcb.h>
|
||
|
||
#include "data.h"
|
||
|
||
#ifndef _CLIENT_H
|
||
#define _CLIENT_H
|
||
|
||
/**
|
||
* Removes the given client from the container, either because it will be
|
||
* inserted into another one or because it was unmapped
|
||
*
|
||
*/
|
||
void client_remove_from_container(xcb_connection_t *conn, Client *client,
|
||
Container *container,
|
||
bool remove_from_focusstack);
|
||
|
||
/**
|
||
* Warps the pointer into the given client (in the middle of it, to be
|
||
* specific), therefore selecting it
|
||
*
|
||
*/
|
||
void client_warp_pointer_into(xcb_connection_t *conn, Client *client);
|
||
|
||
/**
|
||
* Returns true if the client supports the given protocol atom (like WM_DELETE_WINDOW)
|
||
*
|
||
*/
|
||
bool client_supports_protocol(xcb_connection_t *conn, Client *client, xcb_atom_t atom);
|
||
|
||
/**
|
||
* Kills the given window using WM_DELETE_WINDOW or xcb_kill_window
|
||
*
|
||
*/
|
||
void client_kill(xcb_connection_t *conn, Client *window);
|
||
|
||
/**
|
||
* Checks if the given window class and title match the given client Window
|
||
* title is passed as "normal" string and as UCS-2 converted string for
|
||
* matching _NET_WM_NAME capable clients as well as those using legacy hints.
|
||
*
|
||
*/
|
||
bool client_matches_class_name(Client *client, char *to_class, char *to_title,
|
||
char *to_title_ucs, int to_title_ucs_len);
|
||
|
||
/**
|
||
* Enters fullscreen mode for the given client. This is called by toggle_fullscreen
|
||
* and when moving a fullscreen client to another screen.
|
||
*
|
||
*/
|
||
void client_enter_fullscreen(xcb_connection_t *conn, Client *client, bool global);
|
||
|
||
/**
|
||
* Leaves fullscreen mode for the given client. This is called by toggle_fullscreen.
|
||
*
|
||
*/
|
||
void client_leave_fullscreen(xcb_connection_t *conn, Client *client);
|
||
|
||
/**
|
||
* Leaves fullscreen mode for the current client. This is called by toggle_fullscreen.
|
||
*
|
||
*/
|
||
void client_leave_fullscreen(xcb_connection_t *conn, Client *client);
|
||
|
||
/**
|
||
* Toggles fullscreen mode for the given client. It updates the data
|
||
* structures and reconfigures (= resizes/moves) the client and its frame to
|
||
* the full size of the screen. When leaving fullscreen, re-rendering the
|
||
* layout is forced.
|
||
*
|
||
*/
|
||
void client_toggle_fullscreen(xcb_connection_t *conn, Client *client);
|
||
|
||
/**
|
||
* Like client_toggle_fullscreen(), but putting it in global fullscreen-mode.
|
||
*
|
||
*/
|
||
void client_toggle_fullscreen_global(xcb_connection_t *conn, Client *client);
|
||
|
||
/**
|
||
* Sets the position of the given client in the X stack to the highest (tiling
|
||
* layer is always on the same position, so this doesn’t matter) below the
|
||
* first floating client, so that floating windows are always on top.
|
||
*
|
||
*/
|
||
void client_set_below_floating(xcb_connection_t *conn, Client *client);
|
||
|
||
/**
|
||
* Returns true if the client is floating. Makes the code more beatiful, as
|
||
* floating is not simply a boolean, but also saves whether the user selected
|
||
* the current state or whether it was automatically set.
|
||
*
|
||
*/
|
||
bool client_is_floating(Client *client);
|
||
|
||
/**
|
||
* Change the border type for the given client to normal (n), 1px border (p) or
|
||
* completely borderless (b).
|
||
*
|
||
*/
|
||
void client_change_border(xcb_connection_t *conn, Client *client, char border_type);
|
||
|
||
/**
|
||
* Change the border type for the given client to normal (n), 1px border (p) or
|
||
* completely borderless (b) without actually re-rendering the layout. Useful
|
||
* for calling it when initializing a new client.
|
||
*
|
||
*/
|
||
bool client_init_border(xcb_connection_t *conn, Client *client, char border_type);
|
||
|
||
/**
|
||
* Unmap the client, correctly setting any state which is needed.
|
||
*
|
||
*/
|
||
void client_unmap(xcb_connection_t *conn, Client *client);
|
||
|
||
/**
|
||
* Map the client, correctly restoring any state needed.
|
||
*
|
||
*/
|
||
void client_map(xcb_connection_t *conn, Client *client);
|
||
|
||
/**
|
||
* Set the given mark for this client. Used for jumping to the client
|
||
* afterwards (like m<mark> and '<mark> in vim).
|
||
*
|
||
*/
|
||
void client_mark(xcb_connection_t *conn, Client *client, const char *mark);
|
||
|
||
/**
|
||
* Returns the minimum height of a specific window. The height is calculated
|
||
* by using 2 pixels (for the client window itself), possibly padding this to
|
||
* comply with the client’s base_height and then adding the decoration height.
|
||
*
|
||
*/
|
||
uint32_t client_min_height(Client *client);
|
||
|
||
/**
|
||
* See client_min_height.
|
||
*
|
||
*/
|
||
uint32_t client_min_width(Client *client);
|
||
|
||
/**
|
||
* Pretty-prints the client’s information into the logfile.
|
||
*
|
||
*/
|
||
#define CLIENT_LOG(client) do { \
|
||
DLOG("Window: frame 0x%08x, child 0x%08x\n", client->frame, client->child); \
|
||
} while (0)
|
||
|
||
#endif
|