917 lines
31 KiB
C
917 lines
31 KiB
C
#ifndef __XCB_ICCCM_H__
|
|
#define __XCB_ICCCM_H__
|
|
|
|
/*
|
|
* Copyright (C) 2008 Arnaud Fontaine <arnau@debian.org>
|
|
* Copyright (C) 2007-2008 Vincent Torri <vtorri@univ-evry.fr>
|
|
*
|
|
* Permission is hereby granted, free of charge, to any person
|
|
* obtaining a copy of this software and associated documentation
|
|
* files (the "Software"), to deal in the Software without
|
|
* restriction, including without limitation the rights to use, copy,
|
|
* modify, merge, publish, distribute, sublicense, and/or sell copies
|
|
* of the Software, and to permit persons to whom the Software is
|
|
* furnished to do so, subject to the following conditions:
|
|
*
|
|
* The above copyright notice and this permission notice shall be
|
|
* included in all copies or substantial portions of the Software.
|
|
*
|
|
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
|
|
* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
|
|
* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
|
|
* NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
|
|
* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF
|
|
* CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
|
|
* WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
|
|
*
|
|
* Except as contained in this notice, the names of the authors or
|
|
* their institutions shall not be used in advertising or otherwise to
|
|
* promote the sale, use or other dealings in this Software without
|
|
* prior written authorization from the authors.
|
|
*/
|
|
|
|
/**
|
|
* @defgroup xcb__icccm_t XCB ICCCM Functions
|
|
*
|
|
* These functions allow easy handling of the protocol described in the
|
|
* Inter-Client Communication Conventions Manual.
|
|
*
|
|
* @{
|
|
*/
|
|
|
|
#include <xcb/xcb.h>
|
|
#include "xcb_property.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/**
|
|
* @brief TextProperty reply structure.
|
|
*/
|
|
typedef struct {
|
|
/** Store reply to avoid memory allocation, should normally not be
|
|
used directly */
|
|
xcb_get_property_reply_t *_reply;
|
|
/** Encoding used */
|
|
xcb_atom_t encoding;
|
|
/** Length of the name field above */
|
|
uint32_t name_len;
|
|
/** Property value */
|
|
char *name;
|
|
/** Format, may be 8, 16 or 32 */
|
|
uint8_t format;
|
|
} xcb_get_text_property_reply_t;
|
|
|
|
/**
|
|
* @brief Deliver a GetProperty request to the X server.
|
|
* @param c The connection to the X server.
|
|
* @param window Window X identifier.
|
|
* @param property Property atom to get.
|
|
* @return The request cookie.
|
|
*
|
|
* Allow to get a window property, in most case you might want to use
|
|
* above functions to get an ICCCM property for a given window.
|
|
*/
|
|
xcb_get_property_cookie_t xcb_get_text_property(xcb_connection_t *c,
|
|
xcb_window_t window,
|
|
xcb_atom_t property);
|
|
|
|
/**
|
|
* @see xcb_get_text_property()
|
|
*/
|
|
xcb_get_property_cookie_t xcb_get_text_property_unchecked(xcb_connection_t *c,
|
|
xcb_window_t window,
|
|
xcb_atom_t property);
|
|
|
|
/**
|
|
* @brief Fill given structure with the property value of a window.
|
|
* @param c The connection to the X server.
|
|
* @param cookie TextProperty request cookie.
|
|
* @param prop TextProperty reply which is to be filled.
|
|
* @param e Error if any.
|
|
* @return Return 1 on success, 0 otherwise.
|
|
*
|
|
* If the function return 0 (failure), the content of prop is unmodified and
|
|
* therefore the structure must not be wiped.
|
|
*
|
|
* The parameter e supplied to this function must be NULL if
|
|
* xcb_get_text_property_unchecked() is used. Otherwise, it stores
|
|
* the error if any. prop structure members should be freed by
|
|
* xcb_get_text_property_reply_wipe().
|
|
*/
|
|
uint8_t xcb_get_text_property_reply(xcb_connection_t *c,
|
|
xcb_get_property_cookie_t cookie,
|
|
xcb_get_text_property_reply_t *prop,
|
|
xcb_generic_error_t **e);
|
|
|
|
/**
|
|
* @brief Wipe prop structure members previously allocated by
|
|
* xcb_get_text_property_reply().
|
|
* @param prop prop structure whose members is going to be freed.
|
|
*/
|
|
void xcb_get_text_property_reply_wipe(xcb_get_text_property_reply_t *prop);
|
|
|
|
/* WM_NAME */
|
|
|
|
/**
|
|
* @brief Deliver a SetProperty request to set WM_NAME property value.
|
|
* @param c The connection to the X server.
|
|
* @param window Window X identifier.
|
|
* @param encoding Encoding used for the data passed in the name parameter, the set property will also have this encoding as its type.
|
|
* @param name_len Length of name value to set.
|
|
* @param name Name value to set.
|
|
*/
|
|
void xcb_set_wm_name_checked(xcb_connection_t *c,
|
|
xcb_window_t window,
|
|
xcb_atom_t encoding,
|
|
uint32_t name_len,
|
|
const char *name);
|
|
|
|
/**
|
|
* @see xcb_set_wm_name_checked()
|
|
*/
|
|
void xcb_set_wm_name(xcb_connection_t *c, xcb_window_t window,
|
|
xcb_atom_t encoding, uint32_t name_len,
|
|
const char *name);
|
|
|
|
/**
|
|
* @brief Deliver a GetProperty request to the X server for WM_NAME.
|
|
* @param c The connection to the X server.
|
|
* @param window Window X identifier.
|
|
* @return The request cookie.
|
|
*/
|
|
xcb_get_property_cookie_t xcb_get_wm_name(xcb_connection_t *c,
|
|
xcb_window_t window);
|
|
|
|
/**
|
|
* @see xcb_get_wm_name()
|
|
*/
|
|
xcb_get_property_cookie_t xcb_get_wm_name_unchecked(xcb_connection_t *c,
|
|
xcb_window_t window);
|
|
|
|
/**
|
|
* @brief Fill given structure with the WM_NAME property of a window.
|
|
* @param c The connection to the X server.
|
|
* @param cookie Request cookie.
|
|
* @param prop WM_NAME property value.
|
|
* @param e Error if any.
|
|
* @see xcb_get_text_property_reply()
|
|
* @return Return 1 on success, 0 otherwise.
|
|
*/
|
|
uint8_t xcb_get_wm_name_reply(xcb_connection_t *c,
|
|
xcb_get_property_cookie_t cookie,
|
|
xcb_get_text_property_reply_t *prop,
|
|
xcb_generic_error_t **e);
|
|
|
|
/**
|
|
* @brief Set a callback on WM_NAME property changes.
|
|
* @param prophs Property handlers.
|
|
* @param long_len Length of data.
|
|
* @param handler The callback.
|
|
* @param data data given to the callback.
|
|
*/
|
|
void xcb_watch_wm_name(xcb_property_handlers_t *prophs, uint32_t long_len,
|
|
xcb_generic_property_handler_t handler, void *data);
|
|
|
|
/* WM_ICON_NAME */
|
|
|
|
/**
|
|
* @brief Deliver a SetProperty request to set WM_ICON_NAME property value.
|
|
* @param c The connection to the X server.
|
|
* @param window Window X identifier.
|
|
* @param encoding Encoding used for the data passed in the name parameter, the set property will also have this encoding as its type.
|
|
* @param name_len Length of name value to set.
|
|
* @param name Name value to set.
|
|
*/
|
|
void xcb_set_wm_icon_name_checked(xcb_connection_t *c, xcb_window_t window,
|
|
xcb_atom_t encoding, uint32_t name_len,
|
|
const char *name);
|
|
|
|
/**
|
|
* @see xcb_set_wm_icon_name_checked()
|
|
*/
|
|
void xcb_set_wm_icon_name(xcb_connection_t *c, xcb_window_t window,
|
|
xcb_atom_t encoding, uint32_t name_len,
|
|
const char *name);
|
|
|
|
/**
|
|
* @brief Send request to get WM_ICON_NAME property of a window.
|
|
* @param c The connection to the X server.
|
|
* @param window Window X identifier.
|
|
* @return The request cookie.
|
|
*/
|
|
xcb_get_property_cookie_t xcb_get_wm_icon_name(xcb_connection_t *c,
|
|
xcb_window_t window);
|
|
|
|
/**
|
|
* @see xcb_get_wm_icon_name()
|
|
*/
|
|
xcb_get_property_cookie_t xcb_get_wm_icon_name_unchecked(xcb_connection_t *c,
|
|
xcb_window_t window);
|
|
|
|
/**
|
|
* @brief Fill given structure with the WM_ICON_NAME property of a window.
|
|
* @param c The connection to the X server.
|
|
* @param cookie Request cookie.
|
|
* @param prop WM_ICON_NAME property value.
|
|
* @param e Error if any.
|
|
* @see xcb_get_text_property_reply()
|
|
* @return Return 1 on success, 0 otherwise.
|
|
*/
|
|
uint8_t xcb_get_wm_icon_name_reply(xcb_connection_t *c,
|
|
xcb_get_property_cookie_t cookie,
|
|
xcb_get_text_property_reply_t *prop,
|
|
xcb_generic_error_t **e);
|
|
|
|
/**
|
|
* @brief Set a callback on WM_ICON_NAME property changes.
|
|
* @param prophs Property handlers.
|
|
* @param long_len Length of data.
|
|
* @param handler The callback.
|
|
* @param data data given to the callback.
|
|
*/
|
|
void xcb_watch_wm_icon_name(xcb_property_handlers_t *prophs, uint32_t long_len,
|
|
xcb_generic_property_handler_t handler,
|
|
void *data);
|
|
|
|
/* WM_CLIENT_MACHINE */
|
|
|
|
/**
|
|
* @brief Deliver a SetProperty request to set WM_CLIENT_MACHINE property value.
|
|
* @param c The connection to the X server.
|
|
* @param window Window X identifier.
|
|
* @param encoding Encoding used for the data passed in the name parameter, the set property will also have this encoding as its type.
|
|
* @param name_len Length of name value to set.
|
|
* @param name Name value to set.
|
|
*/
|
|
void xcb_set_wm_client_machine_checked(xcb_connection_t *c, xcb_window_t window,
|
|
xcb_atom_t encoding, uint32_t name_len,
|
|
const char *name);
|
|
|
|
/**
|
|
* @see xcb_set_wm_client_machine_checked()
|
|
*/
|
|
void xcb_set_wm_client_machine(xcb_connection_t *c, xcb_window_t window,
|
|
xcb_atom_t encoding, uint32_t name_len,
|
|
const char *name);
|
|
|
|
/**
|
|
* @brief Send request to get WM_CLIENT_MACHINE property of a window.
|
|
* @param c The connection to the X server.
|
|
* @param window Window X identifier.
|
|
* @return The request cookie.
|
|
*/
|
|
xcb_get_property_cookie_t xcb_get_wm_client_machine(xcb_connection_t *c,
|
|
xcb_window_t window);
|
|
|
|
/**
|
|
* @see xcb_get_wm_client_machine()
|
|
*/
|
|
xcb_get_property_cookie_t xcb_get_wm_client_machine_unchecked(xcb_connection_t *c,
|
|
xcb_window_t window);
|
|
|
|
/**
|
|
* @brief Fill given structure with the WM_CLIENT_MACHINE property of a window.
|
|
* @param c The connection to the X server.
|
|
* @param cookie Request cookie.
|
|
* @param prop WM_CLIENT_MACHINE property value.
|
|
* @param e Error if any.
|
|
* @see xcb_get_text_property_reply()
|
|
* @return Return 1 on success, 0 otherwise.
|
|
*/
|
|
uint8_t xcb_get_wm_client_machine_reply(xcb_connection_t *c,
|
|
xcb_get_property_cookie_t cookie,
|
|
xcb_get_text_property_reply_t *prop,
|
|
xcb_generic_error_t **e);
|
|
|
|
/**
|
|
* @brief Set a callback on WM_CLIENT_MACHINE property changes.
|
|
* @param prophs Property handlers.
|
|
* @param long_len Length of data.
|
|
* @param handler The callback.
|
|
* @param data data given to the callback.
|
|
*/
|
|
void xcb_watch_wm_client_machine(xcb_property_handlers_t *prophs,
|
|
uint32_t long_len,
|
|
xcb_generic_property_handler_t handler,
|
|
void *data);
|
|
|
|
/* WM_CLASS */
|
|
|
|
/**
|
|
* @brief WM_CLASS hint structure
|
|
*/
|
|
typedef struct {
|
|
/** Instance name */
|
|
char *instance_name;
|
|
/** Class of application */
|
|
char *class_name;
|
|
/** Store reply to avoid memory allocation, should normally not be
|
|
used directly */
|
|
xcb_get_property_reply_t *_reply;
|
|
} xcb_get_wm_class_reply_t;
|
|
|
|
/**
|
|
* @brief Deliver a GetProperty request to the X server for WM_CLASS.
|
|
* @param c The connection to the X server.
|
|
* @param window Window X identifier.
|
|
* @return The request cookie.
|
|
*/
|
|
xcb_get_property_cookie_t xcb_get_wm_class(xcb_connection_t *c,
|
|
xcb_window_t window);
|
|
|
|
/**
|
|
* @see xcb_get_wm_class()
|
|
*/
|
|
xcb_get_property_cookie_t xcb_get_wm_class_unchecked(xcb_connection_t *c,
|
|
xcb_window_t window);
|
|
|
|
|
|
/**
|
|
* @brief Fill give structure with the WM_CLASS property of a window.
|
|
* @param prop The property structur to fill.
|
|
* @param reply The property request reply.
|
|
* @return Return 1 on success, 0 otherwise.
|
|
*/
|
|
uint8_t
|
|
xcb_get_wm_class_from_reply(xcb_get_wm_class_reply_t *prop,
|
|
xcb_get_property_reply_t *reply);
|
|
|
|
/**
|
|
* @brief Fill given structure with the WM_CLASS property of a window.
|
|
* @param c The connection to the X server.
|
|
* @param cookie Request cookie.
|
|
* @param prop WM_CLASS property value.
|
|
* @param e Error if any.
|
|
* @return Return 1 on success, 0 otherwise.
|
|
*
|
|
* The parameter e supplied to this function must be NULL if
|
|
* xcb_get_wm_class_unchecked() is used. Otherwise, it stores the
|
|
* error if any. prop structure members should be freed by
|
|
* xcb_get_wm_class_reply_wipe().
|
|
*/
|
|
uint8_t xcb_get_wm_class_reply(xcb_connection_t *c,
|
|
xcb_get_property_cookie_t cookie,
|
|
xcb_get_wm_class_reply_t *prop,
|
|
xcb_generic_error_t **e);
|
|
|
|
/**
|
|
* @brief Wipe prop structure members previously allocated by
|
|
* xcb_get_wm_class_reply().
|
|
* @param prop prop structure whose members is going to be freed.
|
|
*/
|
|
void xcb_get_wm_class_reply_wipe(xcb_get_wm_class_reply_t *prop);
|
|
|
|
/* WM_TRANSIENT_FOR */
|
|
|
|
/**
|
|
* @brief Send request to get WM_TRANSIENT_FOR property of a window.
|
|
* @param c The connection to the X server
|
|
* @param window Window X identifier.
|
|
* @return The request cookie.
|
|
*/
|
|
xcb_get_property_cookie_t xcb_get_wm_transient_for(xcb_connection_t *c,
|
|
xcb_window_t window);
|
|
|
|
/**
|
|
* @see xcb_get_wm_transient_for_unchecked()
|
|
*/
|
|
xcb_get_property_cookie_t xcb_get_wm_transient_for_unchecked(xcb_connection_t *c,
|
|
xcb_window_t window);
|
|
|
|
/**
|
|
* @brief Fill given window pointer with the WM_TRANSIENT_FOR property of a window.
|
|
* @param prop WM_TRANSIENT_FOR property value.
|
|
* @param reply The get property request reply.
|
|
* @return Return 1 on success, 0 otherwise.
|
|
*/
|
|
uint8_t
|
|
xcb_get_wm_transient_for_from_reply(xcb_window_t *prop,
|
|
xcb_get_property_reply_t *reply);
|
|
/**
|
|
* @brief Fill given structure with the WM_TRANSIENT_FOR property of a window.
|
|
* @param c The connection to the X server.
|
|
* @param cookie Request cookie.
|
|
* @param prop WM_TRANSIENT_FOR property value.
|
|
* @param e Error if any.
|
|
* @return Return 1 on success, 0 otherwise.
|
|
*
|
|
* The parameter e supplied to this function must be NULL if
|
|
* xcb_get_wm_transient_for_unchecked() is used. Otherwise, it stores
|
|
* the error if any.
|
|
*/
|
|
uint8_t xcb_get_wm_transient_for_reply(xcb_connection_t *c,
|
|
xcb_get_property_cookie_t cookie,
|
|
xcb_window_t *prop,
|
|
xcb_generic_error_t **e);
|
|
|
|
/* WM_SIZE_HINTS */
|
|
|
|
typedef enum {
|
|
XCB_SIZE_HINT_US_POSITION = 1 << 0,
|
|
XCB_SIZE_HINT_US_SIZE = 1 << 1,
|
|
XCB_SIZE_HINT_P_POSITION = 1 << 2,
|
|
XCB_SIZE_HINT_P_SIZE = 1 << 3,
|
|
XCB_SIZE_HINT_P_MIN_SIZE = 1 << 4,
|
|
XCB_SIZE_HINT_P_MAX_SIZE = 1 << 5,
|
|
XCB_SIZE_HINT_P_RESIZE_INC = 1 << 6,
|
|
XCB_SIZE_HINT_P_ASPECT = 1 << 7,
|
|
XCB_SIZE_HINT_BASE_SIZE = 1 << 8,
|
|
XCB_SIZE_HINT_P_WIN_GRAVITY = 1 << 9
|
|
} xcb_size_hints_flags_t;
|
|
|
|
/**
|
|
* @brief Size hints structure.
|
|
*/
|
|
typedef struct {
|
|
/** User specified flags */
|
|
uint32_t flags;
|
|
/** User-specified position */
|
|
int32_t x, y;
|
|
/** User-specified size */
|
|
int32_t width, height;
|
|
/** Program-specified minimum size */
|
|
int32_t min_width, min_height;
|
|
/** Program-specified maximum size */
|
|
int32_t max_width, max_height;
|
|
/** Program-specified resize increments */
|
|
int32_t width_inc, height_inc;
|
|
/** Program-specified minimum aspect ratios */
|
|
int32_t min_aspect_num, min_aspect_den;
|
|
/** Program-specified maximum aspect ratios */
|
|
int32_t max_aspect_num, max_aspect_den;
|
|
/** Program-specified base size */
|
|
int32_t base_width, base_height;
|
|
/** Program-specified window gravity */
|
|
uint32_t win_gravity;
|
|
} xcb_size_hints_t;
|
|
|
|
/**
|
|
* @brief Set size hints to a given position.
|
|
* @param hints SIZE_HINTS structure.
|
|
* @param user_specified Is the size user-specified?
|
|
* @param x The X position.
|
|
* @param y The Y position.
|
|
*/
|
|
void xcb_size_hints_set_position(xcb_size_hints_t *hints, int user_specified,
|
|
int32_t x, int32_t y);
|
|
|
|
/**
|
|
* @brief Set size hints to a given size.
|
|
* @param hints SIZE_HINTS structure.
|
|
* @param user_specified is the size user-specified?
|
|
* @param width The width.
|
|
* @param height The height.
|
|
*/
|
|
void xcb_size_hints_set_size(xcb_size_hints_t *hints, int user_specified,
|
|
int32_t width, int32_t height);
|
|
|
|
/**
|
|
* @brief Set size hints to a given minimum size.
|
|
* @param hints SIZE_HINTS structure.
|
|
* @param width The minimum width.
|
|
* @param height The minimum height.
|
|
*/
|
|
void xcb_size_hints_set_min_size(xcb_size_hints_t *hints, int32_t min_width,
|
|
int32_t min_height);
|
|
|
|
/**
|
|
* @brief Set size hints to a given maximum size.
|
|
* @param hints SIZE_HINTS structure.
|
|
* @param width The maximum width.
|
|
* @param height The maximum height.
|
|
*/
|
|
void xcb_size_hints_set_max_size(xcb_size_hints_t *hints, int32_t max_width,
|
|
int32_t max_height);
|
|
|
|
/**
|
|
* @brief Set size hints to a given resize increments.
|
|
* @param hints SIZE_HINTS structure.
|
|
* @param width The resize increments width.
|
|
* @param height The resize increments height.
|
|
*/
|
|
void xcb_size_hints_set_resize_inc(xcb_size_hints_t *hints, int32_t width_inc,
|
|
int32_t height_inc);
|
|
|
|
/**
|
|
* @brief Set size hints to a given aspect ratios.
|
|
* @param hints SIZE_HINTS structure.
|
|
* @param min_aspect_num The minimum aspect ratios for the width.
|
|
* @param min_aspect_den The minimum aspect ratios for the height.
|
|
* @param max_aspect_num The maximum aspect ratios for the width.
|
|
* @param max_aspect_den The maximum aspect ratios for the height.
|
|
*/
|
|
void xcb_size_hints_set_aspect(xcb_size_hints_t *hints, int32_t min_aspect_num,
|
|
int32_t min_aspect_den, int32_t max_aspect_num,
|
|
int32_t max_aspect_den);
|
|
|
|
/**
|
|
* @brief Set size hints to a given base size.
|
|
* @param hints SIZE_HINTS structure.
|
|
* @param base_width Base width.
|
|
* @param base_height Base height.
|
|
*/
|
|
void xcb_size_hints_set_base_size(xcb_size_hints_t *hints, int32_t base_width,
|
|
int32_t base_height);
|
|
|
|
/**
|
|
* @brief Set size hints to a given window gravity.
|
|
* @param hints SIZE_HINTS structure.
|
|
* @param win_gravity Window gravity value.
|
|
*/
|
|
void xcb_size_hints_set_win_gravity(xcb_size_hints_t *hints,
|
|
uint32_t win_gravity);
|
|
|
|
/**
|
|
* @brief Deliver a ChangeProperty request to set a value to a given property.
|
|
* @param c The connection to the X server.
|
|
* @param window Window X identifier.
|
|
* @param property Property to set value for.
|
|
* @param hints Hints value to set.
|
|
*/
|
|
void xcb_set_wm_size_hints_checked(xcb_connection_t *c, xcb_window_t window,
|
|
xcb_atom_t property, xcb_size_hints_t *hints);
|
|
|
|
/**
|
|
* @see xcb_set_wm_size_hints_checked()
|
|
*/
|
|
void xcb_set_wm_size_hints(xcb_connection_t *c, xcb_window_t window,
|
|
xcb_atom_t property, xcb_size_hints_t *hints);
|
|
|
|
/**
|
|
* @brief Send request to get size hints structure for the named property.
|
|
* @param c The connection to the X server.
|
|
* @param window Window X identifier.
|
|
* @param property Specify the property name.
|
|
* @return The request cookie.
|
|
*/
|
|
xcb_get_property_cookie_t xcb_get_wm_size_hints(xcb_connection_t *c,
|
|
xcb_window_t window,
|
|
xcb_atom_t property);
|
|
|
|
/**
|
|
* @see xcb_get_wm_size_hints()
|
|
*/
|
|
xcb_get_property_cookie_t xcb_get_wm_size_hints_unchecked(xcb_connection_t *c,
|
|
xcb_window_t window,
|
|
xcb_atom_t property);
|
|
|
|
/**
|
|
* @brief Fill given structure with the size hints of the named property.
|
|
* @param c The connection to the X server.
|
|
* @param cookie Request cookie.
|
|
* @param hints Size hints structure.
|
|
* @param e Error if any.
|
|
* @return Return 1 on success, 0 otherwise.
|
|
*
|
|
* The parameter e supplied to this function must be NULL if
|
|
* xcb_get_wm_size_hints_unchecked() is used. Otherwise, it stores
|
|
* the error if any. The returned pointer should be freed.
|
|
*/
|
|
uint8_t xcb_get_wm_size_hints_reply(xcb_connection_t *c,
|
|
xcb_get_property_cookie_t cookie,
|
|
xcb_size_hints_t *hints,
|
|
xcb_generic_error_t **e);
|
|
|
|
/* WM_NORMAL_HINTS */
|
|
|
|
/**
|
|
* @brief Deliver a ChangeProperty request to set WM_NORMAL_HINTS property value.
|
|
* @param c The connection to the X server.
|
|
* @param window Window X identifier.
|
|
* @param hints Hints value to set.
|
|
*/
|
|
void xcb_set_wm_normal_hints_checked(xcb_connection_t *c, xcb_window_t window,
|
|
xcb_size_hints_t *hints);
|
|
|
|
/**
|
|
* @see xcb_set_wm_normal_hints_checked()
|
|
*/
|
|
void xcb_set_wm_normal_hints(xcb_connection_t *c, xcb_window_t window,
|
|
xcb_size_hints_t *hints);
|
|
|
|
/**
|
|
* @brief Send request to get WM_NORMAL_HINTS property of a window.
|
|
* @param c The connection to the X server.
|
|
* @param window Window X identifier.
|
|
* @return The request cookie.
|
|
*/
|
|
xcb_get_property_cookie_t xcb_get_wm_normal_hints(xcb_connection_t *c,
|
|
xcb_window_t window);
|
|
|
|
/**
|
|
* @see xcb_get_wm_normal_hints()
|
|
*/
|
|
xcb_get_property_cookie_t xcb_get_wm_normal_hints_unchecked(xcb_connection_t *c,
|
|
xcb_window_t window);
|
|
|
|
/**
|
|
* @brief Fill given structure with the WM_NORMAL_HINTS property of a window.
|
|
* @param hints WM_NORMAL_HINTS property value.
|
|
* @param reply The get property request reply.
|
|
* @return Return 1 on success, 0 otherwise.
|
|
*/
|
|
uint8_t
|
|
xcb_get_wm_size_hints_from_reply(xcb_size_hints_t *hints,
|
|
xcb_get_property_reply_t *reply);
|
|
|
|
/**
|
|
* @brief Fill given structure with the WM_NORMAL_HINTS property of a window.
|
|
* @param c The connection to the X server.
|
|
* @param cookie Request cookie.
|
|
* @param hints WM_NORMAL_HINTS property value.
|
|
* @param e Error if any.
|
|
* @return Return 1 on success, 0 otherwise.
|
|
*
|
|
* The parameter e supplied to this function must be NULL if
|
|
* xcb_get_wm_normal_hints_unchecked() is used. Otherwise, it stores
|
|
* the error if any. The returned pointer should be freed.
|
|
*/
|
|
uint8_t xcb_get_wm_normal_hints_reply(xcb_connection_t *c,
|
|
xcb_get_property_cookie_t cookie,
|
|
xcb_size_hints_t *hints,
|
|
xcb_generic_error_t **e);
|
|
|
|
/* WM_HINTS */
|
|
|
|
/**
|
|
* @brief WM hints structure (may be extended in the future).
|
|
*/
|
|
typedef struct {
|
|
/** Marks which fields in this structure are defined */
|
|
int32_t flags;
|
|
/** Does this application rely on the window manager to get keyboard
|
|
input? */
|
|
uint32_t input;
|
|
/** See below */
|
|
int32_t initial_state;
|
|
/** Pixmap to be used as icon */
|
|
xcb_pixmap_t icon_pixmap;
|
|
/** Window to be used as icon */
|
|
xcb_window_t icon_window;
|
|
/** Initial position of icon */
|
|
int32_t icon_x, icon_y;
|
|
/** Icon mask bitmap */
|
|
xcb_pixmap_t icon_mask;
|
|
/* Identifier of related window group */
|
|
xcb_window_t window_group;
|
|
} xcb_wm_hints_t;
|
|
|
|
/** Number of elements in this structure */
|
|
#define XCB_NUM_WM_HINTS_ELEMENTS 9
|
|
|
|
/**
|
|
* @brief WM_HINTS window states.
|
|
*/
|
|
typedef enum {
|
|
XCB_WM_STATE_WITHDRAWN = 0,
|
|
XCB_WM_STATE_NORMAL = 1,
|
|
XCB_WM_STATE_ICONIC = 3
|
|
} xcb_wm_state_t;
|
|
|
|
typedef enum {
|
|
XCB_WM_HINT_INPUT = (1L << 0),
|
|
XCB_WM_HINT_STATE = (1L << 1),
|
|
XCB_WM_HINT_ICON_PIXMAP = (1L << 2),
|
|
XCB_WM_HINT_ICON_WINDOW = (1L << 3),
|
|
XCB_WM_HINT_ICON_POSITION = (1L << 4),
|
|
XCB_WM_HINT_ICON_MASK = (1L << 5),
|
|
XCB_WM_HINT_WINDOW_GROUP = (1L << 6),
|
|
XCB_WM_HINT_X_URGENCY = (1L << 8)
|
|
} xcb_wm_t;
|
|
|
|
#define XCB_WM_ALL_HINTS (XCB_WM_HINT_INPUT | XCB_WM_HINT_STATE |\
|
|
XCB_WM_HINT_ICON_PIXMAP | XCB_WM_HINT_ICON_WINDOW |\
|
|
XCB_WM_HINT_ICON_POSITION | XCB_WM_HINT_ICON_MASK |\
|
|
XCB_WM_HINT_WINDOW_GROUP)
|
|
|
|
/**
|
|
* @brief Get urgency hint.
|
|
* @param hints WM_HINTS structure.
|
|
* @return Urgency hint value.
|
|
*/
|
|
uint32_t xcb_wm_hints_get_urgency(xcb_wm_hints_t *hints);
|
|
|
|
/**
|
|
* @brief Set input focus.
|
|
* @param hints WM_HINTS structure.
|
|
* @param input Input focus.
|
|
*/
|
|
void xcb_wm_hints_set_input(xcb_wm_hints_t *hints, uint8_t input);
|
|
|
|
/**
|
|
* @brief Set hints state to 'iconic'.
|
|
* @param hints WM_HINTS structure.
|
|
*/
|
|
void xcb_wm_hints_set_iconic(xcb_wm_hints_t *hints);
|
|
|
|
/**
|
|
* @brief Set hints state to 'normal'.
|
|
* @param hints WM_HINTS structure.
|
|
*/
|
|
void xcb_wm_hints_set_normal(xcb_wm_hints_t *hints);
|
|
|
|
/**
|
|
* @brief Set hints state to 'withdrawn'.
|
|
* @param hints WM_HINTS structure.
|
|
*/
|
|
void xcb_wm_hints_set_withdrawn(xcb_wm_hints_t *hints);
|
|
|
|
/**
|
|
* @brief Set hints state to none.
|
|
* @param hints WM_HINTS structure.
|
|
*/
|
|
void xcb_wm_hints_set_none(xcb_wm_hints_t *hints);
|
|
|
|
/**
|
|
* @brief Set pixmap to be used as icon.
|
|
* @param hints WM_HINTS structure.
|
|
* @param icon_pixmap Pixmap.
|
|
*/
|
|
void xcb_wm_hints_set_icon_pixmap(xcb_wm_hints_t *hints,
|
|
xcb_pixmap_t icon_pixmap);
|
|
|
|
/**
|
|
* @brief Set icon mask bitmap.
|
|
* @param hints WM_HINTS structure.
|
|
* @param icon_mask Pixmap.
|
|
*/
|
|
void xcb_wm_hints_set_icon_mask(xcb_wm_hints_t *hints, xcb_pixmap_t icon_mask);
|
|
|
|
/**
|
|
* @brief Set window identifier to be used as icon.
|
|
* @param hints WM_HINTS structure.
|
|
* @param icon_window Window X identifier.
|
|
*/
|
|
void xcb_wm_hints_set_icon_window(xcb_wm_hints_t *hints,
|
|
xcb_window_t icon_window);
|
|
|
|
/**
|
|
* @brief Set identifier of related window group.
|
|
* @param hints WM_HINTS structure.
|
|
* @param window_group Window X identifier.
|
|
*/
|
|
void xcb_wm_hints_set_window_group(xcb_wm_hints_t *hints,
|
|
xcb_window_t window_group);
|
|
|
|
/**
|
|
* @brief Set urgency hints flag.
|
|
* @param hints WM_HINTS structure.
|
|
*/
|
|
void xcb_wm_hints_set_urgency(xcb_wm_hints_t *hints);
|
|
|
|
/**
|
|
* @brief Deliver a SetProperty request to set WM_HINTS property value.
|
|
* @param c The connection to the X server.
|
|
* @param window Window X identifier.
|
|
* @param hints Hints value to set.
|
|
*/
|
|
void xcb_set_wm_hints_checked(xcb_connection_t *c, xcb_window_t window,
|
|
xcb_wm_hints_t *hints);
|
|
|
|
/**
|
|
* @see xcb_set_wm_hints_checked()
|
|
*/
|
|
void xcb_set_wm_hints(xcb_connection_t *c, xcb_window_t window,
|
|
xcb_wm_hints_t *hints);
|
|
|
|
/**
|
|
* @brief Send request to get WM_HINTS property of a window.
|
|
* @param c The connection to the X server.
|
|
* @param window Window X identifier.
|
|
* @return The request cookie.
|
|
*/
|
|
xcb_get_property_cookie_t xcb_get_wm_hints(xcb_connection_t *c,
|
|
xcb_window_t window);
|
|
|
|
/**
|
|
* @see xcb_get_wm_hints()
|
|
*/
|
|
xcb_get_property_cookie_t xcb_get_wm_hints_unchecked(xcb_connection_t *c,
|
|
xcb_window_t window);
|
|
|
|
/**
|
|
* @brief Fill given structure with the WM_HINTS property of a window.
|
|
* @param hints WM_HINTS property value.
|
|
* @param reply The get property request reply.
|
|
* @return Return 1 on success, 0 otherwise.
|
|
*/
|
|
uint8_t
|
|
xcb_get_wm_hints_from_reply(xcb_wm_hints_t *hints,
|
|
xcb_get_property_reply_t *reply);
|
|
|
|
/**
|
|
* @brief Fill given structure with the WM_HINTS property of a window.
|
|
* @param c The connection to the X server.
|
|
* @param cookie Request cookie.
|
|
* @param hints WM_HINTS property value.
|
|
* @param e Error if any.
|
|
* @return Return 1 on success, 0 otherwise.
|
|
*
|
|
* The parameter e supplied to this function must be NULL if
|
|
* xcb_get_wm_hints_unchecked() is used. Otherwise, it stores the
|
|
* error if any. The returned pointer should be freed.
|
|
*/
|
|
uint8_t xcb_get_wm_hints_reply(xcb_connection_t *c,
|
|
xcb_get_property_cookie_t cookie,
|
|
xcb_wm_hints_t *hints,
|
|
xcb_generic_error_t **e);
|
|
|
|
/* WM_PROTOCOLS */
|
|
|
|
/**
|
|
* @brief Deliver a SetProperty request to set WM_PROTOCOLS property value.
|
|
* @param c The connection to the X server.
|
|
* @param wm_protocols The WM_PROTOCOLS atom.
|
|
* @param window Window X identifier.
|
|
* @param list_len Atom list len.
|
|
* @param list Atom list.
|
|
*/
|
|
void xcb_set_wm_protocols_checked(xcb_connection_t *c, xcb_atom_t wm_protocols,
|
|
xcb_window_t window, uint32_t list_len,
|
|
xcb_atom_t *list);
|
|
|
|
/**
|
|
* @see xcb_set_wm_protocols_checked()
|
|
*/
|
|
void xcb_set_wm_protocols(xcb_connection_t *c, xcb_atom_t wm_protocols,
|
|
xcb_window_t window, uint32_t list_len,
|
|
xcb_atom_t *list);
|
|
|
|
/**
|
|
* @brief WM_PROTOCOLS structure.
|
|
*/
|
|
typedef struct {
|
|
/** Length of the atoms list */
|
|
uint32_t atoms_len;
|
|
/** Atoms list */
|
|
xcb_atom_t *atoms;
|
|
/** Store reply to avoid memory allocation, should normally not be
|
|
used directly */
|
|
xcb_get_property_reply_t *_reply;
|
|
} xcb_get_wm_protocols_reply_t;
|
|
|
|
/**
|
|
* @brief Send request to get WM_PROTOCOLS property of a given window.
|
|
* @param c The connection to the X server.
|
|
* @param window Window X identifier.
|
|
* @return The request cookie.
|
|
*/
|
|
xcb_get_property_cookie_t xcb_get_wm_protocols(xcb_connection_t *c,
|
|
xcb_window_t window,
|
|
xcb_atom_t wm_protocol_atom);
|
|
|
|
/**
|
|
* @see xcb_get_wm_protocols()
|
|
*/
|
|
xcb_get_property_cookie_t xcb_get_wm_protocols_unchecked(xcb_connection_t *c,
|
|
xcb_window_t window,
|
|
xcb_atom_t wm_protocol_atom);
|
|
|
|
/**
|
|
* @brief Fill the given structure with the WM_PROTOCOLS property of a window.
|
|
* @param reply The reply of the GetProperty request.
|
|
* @param protocols WM_PROTOCOLS property value.
|
|
* @return Return 1 on success, 0 otherwise.
|
|
*
|
|
* protocols structure members should be freed by
|
|
* xcb_get_wm_protocols_reply_wipe().
|
|
*/
|
|
uint8_t xcb_get_wm_protocols_from_reply(xcb_get_property_reply_t *reply,
|
|
xcb_get_wm_protocols_reply_t *protocols);
|
|
/**
|
|
* @brief Fill the given structure with the WM_PROTOCOLS property of a window.
|
|
* @param c The connection to the X server.
|
|
* @param cookie Request cookie.
|
|
* @param protocols WM_PROTOCOLS property value.
|
|
* @param e Error if any.
|
|
* @return Return 1 on success, 0 otherwise.
|
|
*
|
|
* The parameter e supplied to this function must be NULL if
|
|
* xcb_get_wm_protocols_unchecked() is used. Otherwise, it stores the
|
|
* error if any. protocols structure members should be freed by
|
|
* xcb_get_wm_protocols_reply_wipe().
|
|
*/
|
|
uint8_t xcb_get_wm_protocols_reply(xcb_connection_t *c,
|
|
xcb_get_property_cookie_t cookie,
|
|
xcb_get_wm_protocols_reply_t *protocols,
|
|
xcb_generic_error_t **e);
|
|
|
|
/**
|
|
* @brief Wipe protocols structure members previously allocated by
|
|
* xcb_get_wm_protocols_reply().
|
|
* @param protocols protocols structure whose members is going to be freed.
|
|
*/
|
|
void xcb_get_wm_protocols_reply_wipe(xcb_get_wm_protocols_reply_t *protocols);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
/**
|
|
* @}
|
|
*/
|
|
|
|
#endif /* __XCB_ICCCM_H__ */
|