#ifndef __XCB_ICCCM_H__ #define __XCB_ICCCM_H__ /* * Copyright (C) 2008 Arnaud Fontaine * Copyright (C) 2007-2008 Vincent Torri * * 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 #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_icccm_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_icccm_get_text_property(xcb_connection_t *c, xcb_window_t window, xcb_atom_t property); /** * @see xcb_icccm_get_text_property() */ xcb_get_property_cookie_t xcb_icccm_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_icccm_get_text_property_unchecked() is used. Otherwise, it stores * the error if any. prop structure members should be freed by * xcb_icccm_get_text_property_reply_wipe(). */ uint8_t xcb_icccm_get_text_property_reply(xcb_connection_t *c, xcb_get_property_cookie_t cookie, xcb_icccm_get_text_property_reply_t *prop, xcb_generic_error_t **e); /** * @brief Wipe prop structure members previously allocated by * xcb_icccm_get_text_property_reply(). * @param prop prop structure whose members is going to be freed. */ void xcb_icccm_get_text_property_reply_wipe(xcb_icccm_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 format Encoding format. * @param name_len Length of name value to set. * @param name Name value to set. */ xcb_void_cookie_t xcb_icccm_set_wm_name_checked(xcb_connection_t *c, xcb_window_t window, xcb_atom_t encoding, uint8_t format, uint32_t name_len, const char *name); /** * @see xcb_icccm_set_wm_name_checked() */ xcb_void_cookie_t xcb_icccm_set_wm_name(xcb_connection_t *c, xcb_window_t window, xcb_atom_t encoding, uint8_t format, 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_icccm_get_wm_name(xcb_connection_t *c, xcb_window_t window); /** * @see xcb_icccm_get_wm_name() */ xcb_get_property_cookie_t xcb_icccm_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_icccm_get_text_property_reply() * @return Return 1 on success, 0 otherwise. */ uint8_t xcb_icccm_get_wm_name_reply(xcb_connection_t *c, xcb_get_property_cookie_t cookie, xcb_icccm_get_text_property_reply_t *prop, xcb_generic_error_t **e); /* 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 format Encoding format. * @param name_len Length of name value to set. * @param name Name value to set. */ xcb_void_cookie_t xcb_icccm_set_wm_icon_name_checked(xcb_connection_t *c, xcb_window_t window, xcb_atom_t encoding, uint8_t format, uint32_t name_len, const char *name); /** * @see xcb_icccm_set_wm_icon_name_checked() */ xcb_void_cookie_t xcb_icccm_set_wm_icon_name(xcb_connection_t *c, xcb_window_t window, xcb_atom_t encoding, uint8_t format, 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_icccm_get_wm_icon_name(xcb_connection_t *c, xcb_window_t window); /** * @see xcb_icccm_get_wm_icon_name() */ xcb_get_property_cookie_t xcb_icccm_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_icccm_get_text_property_reply() * @return Return 1 on success, 0 otherwise. */ uint8_t xcb_icccm_get_wm_icon_name_reply(xcb_connection_t *c, xcb_get_property_cookie_t cookie, xcb_icccm_get_text_property_reply_t *prop, xcb_generic_error_t **e); /* WM_COLORMAP_WINDOWS */ /** * @brief Deliver a ChangeProperty request to set WM_COLORMAP_WINDOWS property value. * @param c The connection to the X server. * @param wm_colormap_windows The WM_COLORMAP_WINDOWS atom * @param window Window X identifier. * @param list_len Windows list len. * @param list Windows list. * @return The request cookie. */ xcb_void_cookie_t xcb_icccm_set_wm_colormap_windows_checked(xcb_connection_t *c, xcb_window_t window, xcb_atom_t wm_colormap_windows_atom, uint32_t list_len, const xcb_window_t *list); /** * @see xcb_icccm_set_wm_colormap_windows_checked() */ xcb_void_cookie_t xcb_icccm_set_wm_colormap_windows(xcb_connection_t *c, xcb_window_t window, xcb_atom_t wm_colormap_windows_atom, uint32_t list_len, const xcb_window_t *list); /** * @brief WM_COLORMAP_WINDOWS structure. */ typedef struct { /** Length of the windows list */ uint32_t windows_len; /** Windows list */ xcb_window_t *windows; /** Store reply to avoid memory allocation, should normally not be used directly */ xcb_get_property_reply_t *_reply; } xcb_icccm_get_wm_colormap_windows_reply_t; /** * @brief Send request to get WM_COLORMAP_WINDOWS 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_icccm_get_wm_colormap_windows(xcb_connection_t *c, xcb_window_t window, xcb_atom_t wm_colormap_windows_atom); /** * @see xcb_icccm_get_wm_colormap_windows() */ xcb_get_property_cookie_t xcb_icccm_get_wm_colormap_windows_unchecked(xcb_connection_t *c, xcb_window_t window, xcb_atom_t wm_colormap_windows_atom); /** * @brief Fill the given structure with the WM_COLORMAP_WINDOWS property of a window. * @param reply The reply of the GetProperty request. * @param colormap_windows WM_COLORMAP property value. * @return Return 1 on success, 0 otherwise. * * protocols structure members should be freed by * xcb_icccm_get_wm_protocols_reply_wipe(). */ uint8_t xcb_icccm_get_wm_colormap_windows_from_reply(xcb_get_property_reply_t *reply, xcb_icccm_get_wm_colormap_windows_reply_t *colormap_windows); /** * @brief Fill the given structure with the WM_COLORMAP_WINDOWS property of a window. * @param c The connection to the X server. * @param cookie Request cookie. * @param protocols WM_COLORMAP_WINDOWS 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_icccm_get_wm_colormap_windows_unchecked() is used. Otherwise, it * stores the error if any. protocols structure members should be * freed by xcb_icccm_get_wm_colormap_windows_reply_wipe(). */ uint8_t xcb_icccm_get_wm_colormap_windows_reply(xcb_connection_t *c, xcb_get_property_cookie_t cookie, xcb_icccm_get_wm_colormap_windows_reply_t *windows, xcb_generic_error_t **e); /** * @brief Wipe protocols structure members previously allocated by * xcb_icccm_get_wm_colormap_windows_reply(). * @param windows windows structure whose members is going to be freed. */ void xcb_icccm_get_wm_colormap_windows_reply_wipe(xcb_icccm_get_wm_colormap_windows_reply_t *windows); /* 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 format Encoding format. * @param name_len Length of name value to set. * @param name Name value to set. */ xcb_void_cookie_t xcb_icccm_set_wm_client_machine_checked(xcb_connection_t *c, xcb_window_t window, xcb_atom_t encoding, uint8_t format, uint32_t name_len, const char *name); /** * @see xcb_icccm_set_wm_client_machine_checked() */ xcb_void_cookie_t xcb_icccm_set_wm_client_machine(xcb_connection_t *c, xcb_window_t window, xcb_atom_t encoding, uint8_t format, 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_icccm_get_wm_client_machine(xcb_connection_t *c, xcb_window_t window); /** * @see xcb_icccm_get_wm_client_machine() */ xcb_get_property_cookie_t xcb_icccm_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_icccm_get_text_property_reply() * @return Return 1 on success, 0 otherwise. */ uint8_t xcb_icccm_get_wm_client_machine_reply(xcb_connection_t *c, xcb_get_property_cookie_t cookie, xcb_icccm_get_text_property_reply_t *prop, xcb_generic_error_t **e); /* WM_CLASS */ /** * @brief WM_CLASS hint structure */ /** * @brief Deliver a SetProperty request to set WM_CLASS property value. * * WM_CLASS string is a concatenation of the instance and class name * strings respectively (including null character). * * @param c The connection to the X server. * @param window Window X identifier. * @param class_len Length of WM_CLASS string. * @param class_name WM_CLASS string. * @return The request cookie. */ xcb_void_cookie_t xcb_icccm_set_wm_class_checked(xcb_connection_t *c, xcb_window_t window, uint32_t class_len, const char *class_name); /** * @see xcb_icccm_set_wm_class_checked() */ xcb_void_cookie_t xcb_icccm_set_wm_class(xcb_connection_t *c, xcb_window_t window, uint32_t class_len, const char *class_name); 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_icccm_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_icccm_get_wm_class(xcb_connection_t *c, xcb_window_t window); /** * @see xcb_icccm_get_wm_class() */ xcb_get_property_cookie_t xcb_icccm_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 structure to fill. * @param reply The property request reply. * @return Return 1 on success, 0 otherwise. */ uint8_t xcb_icccm_get_wm_class_from_reply(xcb_icccm_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_icccm_get_wm_class_unchecked() is used. Otherwise, it stores the * error if any. prop structure members should be freed by * xcb_icccm_get_wm_class_reply_wipe(). */ uint8_t xcb_icccm_get_wm_class_reply(xcb_connection_t *c, xcb_get_property_cookie_t cookie, xcb_icccm_get_wm_class_reply_t *prop, xcb_generic_error_t **e); /** * @brief Wipe prop structure members previously allocated by * xcb_icccm_get_wm_class_reply(). * @param prop prop structure whose members is going to be freed. */ void xcb_icccm_get_wm_class_reply_wipe(xcb_icccm_get_wm_class_reply_t *prop); /* WM_TRANSIENT_FOR */ /** * @brief Deliver a SetProperty request to set WM_TRANSIENT_FOR property value. * @param c The connection to the X server. * @param window Window X identifier. * @param transient_for_window The WM_TRANSIENT_FOR window X identifier. * @return The request cookie. */ xcb_void_cookie_t xcb_icccm_set_wm_transient_for_checked(xcb_connection_t *c, xcb_window_t window, xcb_window_t transient_for_window); /** * @see xcb_icccm_set_wm_transient_for */ xcb_void_cookie_t xcb_icccm_set_wm_transient_for(xcb_connection_t *c, xcb_window_t window, xcb_window_t transient_for_window); /** * @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_icccm_get_wm_transient_for(xcb_connection_t *c, xcb_window_t window); /** * @see xcb_icccm_get_wm_transient_for_unchecked() */ xcb_get_property_cookie_t xcb_icccm_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_icccm_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_icccm_get_wm_transient_for_unchecked() is used. Otherwise, it stores * the error if any. */ uint8_t xcb_icccm_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_ICCCM_SIZE_HINT_US_POSITION = 1 << 0, XCB_ICCCM_SIZE_HINT_US_SIZE = 1 << 1, XCB_ICCCM_SIZE_HINT_P_POSITION = 1 << 2, XCB_ICCCM_SIZE_HINT_P_SIZE = 1 << 3, XCB_ICCCM_SIZE_HINT_P_MIN_SIZE = 1 << 4, XCB_ICCCM_SIZE_HINT_P_MAX_SIZE = 1 << 5, XCB_ICCCM_SIZE_HINT_P_RESIZE_INC = 1 << 6, XCB_ICCCM_SIZE_HINT_P_ASPECT = 1 << 7, XCB_ICCCM_SIZE_HINT_BASE_SIZE = 1 << 8, XCB_ICCCM_SIZE_HINT_P_WIN_GRAVITY = 1 << 9 } xcb_icccm_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; /** Number of elements in this structure */ #define XCB_ICCCM_NUM_WM_SIZE_HINTS_ELEMENTS 18 /** * @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_icccm_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_icccm_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_icccm_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_icccm_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_icccm_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_icccm_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_icccm_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_icccm_size_hints_set_win_gravity(xcb_size_hints_t *hints, xcb_gravity_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. */ xcb_void_cookie_t xcb_icccm_set_wm_size_hints_checked(xcb_connection_t *c, xcb_window_t window, xcb_atom_t property, xcb_size_hints_t *hints); /** * @see xcb_icccm_set_wm_size_hints_checked() */ xcb_void_cookie_t xcb_icccm_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_icccm_get_wm_size_hints(xcb_connection_t *c, xcb_window_t window, xcb_atom_t property); /** * @see xcb_icccm_get_wm_size_hints() */ xcb_get_property_cookie_t xcb_icccm_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_icccm_get_wm_size_hints_unchecked() is used. Otherwise, it stores * the error if any. The returned pointer should be freed. */ uint8_t xcb_icccm_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. */ xcb_void_cookie_t xcb_icccm_set_wm_normal_hints_checked(xcb_connection_t *c, xcb_window_t window, xcb_size_hints_t *hints); /** * @see xcb_icccm_set_wm_normal_hints_checked() */ xcb_void_cookie_t xcb_icccm_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_icccm_get_wm_normal_hints(xcb_connection_t *c, xcb_window_t window); /** * @see xcb_icccm_get_wm_normal_hints() */ xcb_get_property_cookie_t xcb_icccm_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_icccm_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_icccm_get_wm_normal_hints_unchecked() is used. Otherwise, it stores * the error if any. The returned pointer should be freed. */ uint8_t xcb_icccm_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_icccm_wm_hints_t; /** Number of elements in this structure */ #define XCB_ICCCM_NUM_WM_HINTS_ELEMENTS 9 /** * @brief WM_HINTS window states. */ typedef enum { XCB_ICCCM_WM_STATE_WITHDRAWN = 0, XCB_ICCCM_WM_STATE_NORMAL = 1, XCB_ICCCM_WM_STATE_ICONIC = 3 } xcb_icccm_wm_state_t; typedef enum { XCB_ICCCM_WM_HINT_INPUT = (1L << 0), XCB_ICCCM_WM_HINT_STATE = (1L << 1), XCB_ICCCM_WM_HINT_ICON_PIXMAP = (1L << 2), XCB_ICCCM_WM_HINT_ICON_WINDOW = (1L << 3), XCB_ICCCM_WM_HINT_ICON_POSITION = (1L << 4), XCB_ICCCM_WM_HINT_ICON_MASK = (1L << 5), XCB_ICCCM_WM_HINT_WINDOW_GROUP = (1L << 6), XCB_ICCCM_WM_HINT_X_URGENCY = (1L << 8) } xcb_icccm_wm_t; #define XCB_ICCCM_WM_ALL_HINTS (XCB_ICCCM_WM_HINT_INPUT | XCB_ICCCM_WM_HINT_STATE | \ XCB_ICCCM_WM_HINT_ICON_PIXMAP | XCB_ICCCM_WM_HINT_ICON_WINDOW | \ XCB_ICCCM_WM_HINT_ICON_POSITION | XCB_ICCCM_WM_HINT_ICON_MASK | \ XCB_ICCCM_WM_HINT_WINDOW_GROUP) /** * @brief Get urgency hint. * @param hints WM_HINTS structure. * @return Urgency hint value. */ uint32_t xcb_icccm_wm_hints_get_urgency(xcb_icccm_wm_hints_t *hints); /** * @brief Set input focus. * @param hints WM_HINTS structure. * @param input Input focus. */ void xcb_icccm_wm_hints_set_input(xcb_icccm_wm_hints_t *hints, uint8_t input); /** * @brief Set hints state to 'iconic'. * @param hints WM_HINTS structure. */ void xcb_icccm_wm_hints_set_iconic(xcb_icccm_wm_hints_t *hints); /** * @brief Set hints state to 'normal'. * @param hints WM_HINTS structure. */ void xcb_icccm_wm_hints_set_normal(xcb_icccm_wm_hints_t *hints); /** * @brief Set hints state to 'withdrawn'. * @param hints WM_HINTS structure. */ void xcb_icccm_wm_hints_set_withdrawn(xcb_icccm_wm_hints_t *hints); /** * @brief Set hints state to none. * @param hints WM_HINTS structure. */ void xcb_icccm_wm_hints_set_none(xcb_icccm_wm_hints_t *hints); /** * @brief Set pixmap to be used as icon. * @param hints WM_HINTS structure. * @param icon_pixmap Pixmap. */ void xcb_icccm_wm_hints_set_icon_pixmap(xcb_icccm_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_icccm_wm_hints_set_icon_mask(xcb_icccm_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_icccm_wm_hints_set_icon_window(xcb_icccm_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_icccm_wm_hints_set_window_group(xcb_icccm_wm_hints_t *hints, xcb_window_t window_group); /** * @brief Set urgency hints flag. * @param hints WM_HINTS structure. */ void xcb_icccm_wm_hints_set_urgency(xcb_icccm_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. */ xcb_void_cookie_t xcb_icccm_set_wm_hints_checked(xcb_connection_t *c, xcb_window_t window, xcb_icccm_wm_hints_t *hints); /** * @see xcb_icccm_set_wm_hints_checked() */ xcb_void_cookie_t xcb_icccm_set_wm_hints(xcb_connection_t *c, xcb_window_t window, xcb_icccm_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_icccm_get_wm_hints(xcb_connection_t *c, xcb_window_t window); /** * @see xcb_icccm_get_wm_hints() */ xcb_get_property_cookie_t xcb_icccm_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_icccm_get_wm_hints_from_reply(xcb_icccm_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_icccm_get_wm_hints_unchecked() is used. Otherwise, it stores the * error if any. The returned pointer should be freed. */ uint8_t xcb_icccm_get_wm_hints_reply(xcb_connection_t *c, xcb_get_property_cookie_t cookie, xcb_icccm_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. */ xcb_void_cookie_t xcb_icccm_set_wm_protocols_checked(xcb_connection_t *c, xcb_window_t window, xcb_atom_t wm_protocols, uint32_t list_len, xcb_atom_t *list); /** * @see xcb_icccm_set_wm_protocols_checked() */ xcb_void_cookie_t xcb_icccm_set_wm_protocols(xcb_connection_t *c, xcb_window_t window, xcb_atom_t wm_protocols, 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_icccm_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_icccm_get_wm_protocols(xcb_connection_t *c, xcb_window_t window, xcb_atom_t wm_protocol_atom); /** * @see xcb_icccm_get_wm_protocols() */ xcb_get_property_cookie_t xcb_icccm_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_icccm_get_wm_protocols_reply_wipe(). */ uint8_t xcb_icccm_get_wm_protocols_from_reply(xcb_get_property_reply_t *reply, xcb_icccm_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_icccm_get_wm_protocols_unchecked() is used. Otherwise, it stores the * error if any. protocols structure members should be freed by * xcb_icccm_get_wm_protocols_reply_wipe(). */ uint8_t xcb_icccm_get_wm_protocols_reply(xcb_connection_t *c, xcb_get_property_cookie_t cookie, xcb_icccm_get_wm_protocols_reply_t *protocols, xcb_generic_error_t **e); /** * @brief Wipe protocols structure members previously allocated by * xcb_icccm_get_wm_protocols_reply(). * @param protocols protocols structure whose members is going to be freed. */ void xcb_icccm_get_wm_protocols_reply_wipe(xcb_icccm_get_wm_protocols_reply_t *protocols); #ifdef __cplusplus } #endif /** * @} */ #endif /* __XCB_ICCCM_H__ */