diff options
Diffstat (limited to 'icccm')
-rw-r--r-- | icccm/Makefile.am | 18 | ||||
-rw-r--r-- | icccm/icccm.c | 726 | ||||
-rw-r--r-- | icccm/xcb-icccm.pc.in | 11 | ||||
-rw-r--r-- | icccm/xcb_icccm.h | 916 |
4 files changed, 0 insertions, 1671 deletions
diff --git a/icccm/Makefile.am b/icccm/Makefile.am deleted file mode 100644 index 9ad4238..0000000 --- a/icccm/Makefile.am +++ /dev/null @@ -1,18 +0,0 @@ - -MAINTAINERCLEANFILES = Makefile.in - -lib_LTLIBRARIES = libxcb-icccm.la - -xcbinclude_HEADERS = xcb_icccm.h - -AM_CFLAGS = $(CWARNFLAGS) - -libxcb_icccm_la_SOURCES = icccm.c -libxcb_icccm_la_CPPFLAGS = $(XCB_CFLAGS) $(XCB_ATOM_CFLAGS) $(XCB_EVENT_CFLAGS) \ - $(XCB_PROPERTY_CFLAGS) -libxcb_icccm_la_LIBADD = $(XCB_LIBS) $(XCB_ATOM_LIBS) $(XCB_PROPERTY_LIBS) -libxcb_icccm_la_LDFLAGS = -version-info 1:0:0 - -pkgconfig_DATA = xcb-icccm.pc - -EXTRA_DIST = xcb-icccm.pc.in diff --git a/icccm/icccm.c b/icccm/icccm.c deleted file mode 100644 index 776c299..0000000 --- a/icccm/icccm.c +++ /dev/null @@ -1,726 +0,0 @@ -/* - * Copyright © 2008 Arnaud Fontaine <arnau@debian.org> - * Copyright © 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. - */ - -#include <stdlib.h> -#include <limits.h> -#include <string.h> - -#include "xcb_icccm.h" -#include "xcb_atom.h" - -xcb_get_property_cookie_t -xcb_get_text_property(xcb_connection_t *c, - xcb_window_t window, - xcb_atom_t property) -{ - return xcb_get_any_property(c, 0, window, property, UINT_MAX); -} - -xcb_get_property_cookie_t -xcb_get_text_property_unchecked(xcb_connection_t *c, - xcb_window_t window, - xcb_atom_t property) -{ - return xcb_get_any_property_unchecked(c, 0, window, property, UINT_MAX); -} - -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) -{ - xcb_get_property_reply_t *reply = xcb_get_property_reply(c, cookie, e); - - if(!reply) - return 0; - - prop->_reply = reply; - prop->encoding = prop->_reply->type; - prop->format = prop->_reply->format; - prop->name_len = xcb_get_property_value_length(prop->_reply); - prop->name = xcb_get_property_value(prop->_reply); - - return 1; -} - -void -xcb_get_text_property_reply_wipe(xcb_get_text_property_reply_t *prop) -{ - free(prop->_reply); -} - -/* WM_NAME */ - -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) -{ - xcb_change_property_checked(c, XCB_PROP_MODE_REPLACE, window, WM_NAME, - encoding, 8, name_len, name); -} - -void -xcb_set_wm_name(xcb_connection_t *c, xcb_window_t window, xcb_atom_t encoding, - uint32_t name_len, const char *name) -{ - xcb_change_property(c, XCB_PROP_MODE_REPLACE, window, WM_NAME, encoding, 8, - name_len, name); -} - -xcb_get_property_cookie_t -xcb_get_wm_name(xcb_connection_t *c, - xcb_window_t window) -{ - return xcb_get_text_property(c, window, WM_NAME); -} - -xcb_get_property_cookie_t -xcb_get_wm_name_unchecked(xcb_connection_t *c, - xcb_window_t window) -{ - return xcb_get_text_property_unchecked(c, window, WM_NAME); -} - -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) -{ - return xcb_get_text_property_reply(c, cookie, prop, e); -} - -void -xcb_watch_wm_name(xcb_property_handlers_t *prophs, uint32_t long_len, - xcb_generic_property_handler_t handler, void *data) -{ - xcb_property_set_handler(prophs, WM_NAME, long_len, handler, data); -} - -/* WM_ICON_NAME */ - -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) -{ - xcb_change_property_checked(c, XCB_PROP_MODE_REPLACE, window, WM_ICON_NAME, - encoding, 8, name_len, name); -} - -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) -{ - xcb_change_property(c, XCB_PROP_MODE_REPLACE, window, WM_ICON_NAME, encoding, - 8, name_len, name); -} - -xcb_get_property_cookie_t -xcb_get_wm_icon_name(xcb_connection_t *c, - xcb_window_t window) -{ - return xcb_get_text_property(c, window, WM_ICON_NAME); -} - -xcb_get_property_cookie_t -xcb_get_wm_icon_name_unchecked(xcb_connection_t *c, - xcb_window_t window) -{ - return xcb_get_text_property_unchecked(c, window, WM_ICON_NAME); -} - -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) -{ - return xcb_get_text_property_reply(c, cookie, prop, e); -} - -void -xcb_watch_wm_icon_name(xcb_property_handlers_t *prophs, uint32_t long_len, - xcb_generic_property_handler_t handler, void *data) -{ - xcb_property_set_handler(prophs, WM_ICON_NAME, long_len, handler, data); -} - -/* WM_CLIENT_MACHINE */ - -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) -{ - xcb_change_property_checked(c, XCB_PROP_MODE_REPLACE, window, - WM_CLIENT_MACHINE, encoding, 8, name_len, name); -} - -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) -{ - xcb_change_property(c, XCB_PROP_MODE_REPLACE, window, WM_CLIENT_MACHINE, - encoding, 8, name_len, name); -} - -xcb_get_property_cookie_t -xcb_get_wm_client_machine(xcb_connection_t *c, - xcb_window_t window) -{ - return xcb_get_text_property(c, window, WM_CLIENT_MACHINE); -} - -xcb_get_property_cookie_t -xcb_get_wm_client_machine_unchecked(xcb_connection_t *c, - xcb_window_t window) -{ - return xcb_get_text_property_unchecked(c, window, WM_CLIENT_MACHINE); -} - -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) -{ - return xcb_get_text_property_reply(c, cookie, prop, e); -} - -void -xcb_watch_wm_client_machine(xcb_property_handlers_t *prophs, uint32_t long_len, - xcb_generic_property_handler_t handler, void *data) -{ - xcb_property_set_handler(prophs, WM_CLIENT_MACHINE, long_len, handler, data); -} - -/* WM_CLASS */ - -xcb_get_property_cookie_t -xcb_get_wm_class(xcb_connection_t *c, xcb_window_t window) -{ - return xcb_get_property(c, 0, window, WM_CLASS, STRING, 0L, 2048L); -} - -xcb_get_property_cookie_t -xcb_get_wm_class_unchecked(xcb_connection_t *c, xcb_window_t window) -{ - return xcb_get_property_unchecked(c, 0, window, WM_CLASS, STRING, 0L, 2048L); -} - -uint8_t -xcb_get_wm_class_from_reply(xcb_get_wm_class_reply_t *prop, - xcb_get_property_reply_t *reply) -{ - if(!reply || reply->type != STRING || reply->format != 8) - return 0; - - prop->_reply = reply; - prop->instance_name = (char *) xcb_get_property_value(prop->_reply); - - int name_len = strlen(prop->instance_name); - if(name_len == xcb_get_property_value_length(prop->_reply)) - name_len--; - - prop->class_name = prop->instance_name + name_len + 1; - - return 1; -} - -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) -{ - xcb_get_property_reply_t *reply = xcb_get_property_reply(c, cookie, e); - uint8_t ret = xcb_get_wm_class_from_reply(prop, reply); - /* if reply parsing failed, free the reply to avoid mem leak */ - if(!ret) - free(reply); - return ret; -} - -void -xcb_get_wm_class_reply_wipe(xcb_get_wm_class_reply_t *prop) -{ - free(prop->_reply); -} - -/* WM_TRANSIENT_FOR */ - -xcb_get_property_cookie_t -xcb_get_wm_transient_for(xcb_connection_t *c, xcb_window_t window) -{ - return xcb_get_property(c, 0, window, WM_TRANSIENT_FOR, WINDOW, 0, 1); -} - -xcb_get_property_cookie_t -xcb_get_wm_transient_for_unchecked(xcb_connection_t *c, xcb_window_t window) -{ - return xcb_get_property_unchecked(c, 0, window, WM_TRANSIENT_FOR, WINDOW, 0, 1); -} - -uint8_t -xcb_get_wm_transient_for_from_reply(xcb_window_t *prop, - xcb_get_property_reply_t *reply) -{ - if(!reply || reply->type != WINDOW || reply->format != 32 || !reply->length) - return 0; - - *prop = *((xcb_window_t *) xcb_get_property_value(reply)); - - return 1; -} - -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) -{ - xcb_get_property_reply_t *reply = xcb_get_property_reply(c, cookie, e); - uint8_t ret = xcb_get_wm_transient_for_from_reply(prop, reply); - free(reply); - return ret; -} - -/* WM_SIZE_HINTS */ - -void -xcb_size_hints_set_position(xcb_size_hints_t *hints, int user_specified, - int32_t x, int32_t y) -{ - hints->flags &= ~(XCB_SIZE_HINT_US_POSITION | XCB_SIZE_HINT_P_POSITION); - if (user_specified) - hints->flags |= XCB_SIZE_HINT_US_POSITION; - else - hints->flags |= XCB_SIZE_HINT_P_POSITION; - hints->x = x; - hints->y = y; -} - -void -xcb_size_hints_set_size(xcb_size_hints_t *hints, int user_specified, - int32_t width, int32_t height) -{ - hints->flags &= ~(XCB_SIZE_HINT_US_SIZE | XCB_SIZE_HINT_P_SIZE); - if (user_specified) - hints->flags |= XCB_SIZE_HINT_US_SIZE; - else - hints->flags |= XCB_SIZE_HINT_P_SIZE; - hints->width = width; - hints->height = height; -} - -void -xcb_size_hints_set_min_size(xcb_size_hints_t *hints, int32_t min_width, - int32_t min_height) -{ - hints->flags |= XCB_SIZE_HINT_P_MIN_SIZE; - hints->min_width = min_width; - hints->min_height = min_height; -} - -void -xcb_size_hints_set_max_size(xcb_size_hints_t *hints, int32_t max_width, - int32_t max_height) -{ - hints->flags |= XCB_SIZE_HINT_P_MAX_SIZE; - hints->max_width = max_width; - hints->max_height = max_height; -} - -void -xcb_size_hints_set_resize_inc(xcb_size_hints_t *hints, int32_t width_inc, - int32_t height_inc) -{ - hints->flags |= XCB_SIZE_HINT_P_RESIZE_INC; - hints->width_inc = width_inc; - hints->height_inc = height_inc; -} - -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) -{ - hints->flags |= XCB_SIZE_HINT_P_ASPECT; - hints->min_aspect_num = min_aspect_num; - hints->min_aspect_den = min_aspect_den; - hints->max_aspect_num = max_aspect_num; - hints->max_aspect_den = max_aspect_den; -} - -void -xcb_size_hints_set_base_size(xcb_size_hints_t *hints, int32_t base_width, - int32_t base_height) -{ - hints->flags |= XCB_SIZE_HINT_BASE_SIZE; - hints->base_width = base_width; - hints->base_height = base_height; -} - -void -xcb_size_hints_set_win_gravity(xcb_size_hints_t *hints, xcb_gravity_t win_gravity) -{ - hints->flags |= XCB_SIZE_HINT_P_WIN_GRAVITY; - hints->win_gravity = win_gravity; -} - -void -xcb_set_wm_size_hints_checked(xcb_connection_t *c, xcb_window_t window, - xcb_atom_t property, xcb_size_hints_t *hints) -{ - xcb_change_property_checked(c, XCB_PROP_MODE_REPLACE, window, property, - WM_SIZE_HINTS, 32, sizeof(*hints) >> 2, hints); -} - -void -xcb_set_wm_size_hints(xcb_connection_t *c, xcb_window_t window, - xcb_atom_t property, xcb_size_hints_t *hints) -{ - xcb_change_property(c, XCB_PROP_MODE_REPLACE, window, property, - WM_SIZE_HINTS, 32, sizeof(*hints) >> 2, hints); -} - -xcb_get_property_cookie_t -xcb_get_wm_size_hints(xcb_connection_t *c, xcb_window_t window, - xcb_atom_t property) -{ - /* NumPropSizeElements = 18 (ICCCM version 1). */ - return xcb_get_property(c, 0, window, property, WM_SIZE_HINTS, 0L, 18); -} - -xcb_get_property_cookie_t -xcb_get_wm_size_hints_unchecked(xcb_connection_t *c, xcb_window_t window, - xcb_atom_t property) -{ - return xcb_get_property_unchecked(c, 0, window, property, WM_SIZE_HINTS, - 0L, 18); -} - -uint8_t -xcb_get_wm_size_hints_from_reply(xcb_size_hints_t *hints, xcb_get_property_reply_t *reply) -{ - uint32_t flags; - - if(!reply) - return 0; - - int length = xcb_get_property_value_length(reply) / (reply->format / 8); - - if (!(reply->type == WM_SIZE_HINTS && - (reply->format == 8 || reply->format == 16 || - reply->format == 32) && - /* OldNumPropSizeElements = 15 (pre-ICCCM) */ - length >= 15)) - return 0; - - memcpy(hints, (xcb_size_hints_t *) xcb_get_property_value (reply), - length * reply->format >> 3); - - flags = (XCB_SIZE_HINT_US_POSITION | XCB_SIZE_HINT_US_SIZE | - XCB_SIZE_HINT_P_POSITION | XCB_SIZE_HINT_P_SIZE | - XCB_SIZE_HINT_P_MIN_SIZE | XCB_SIZE_HINT_P_MAX_SIZE | - XCB_SIZE_HINT_P_RESIZE_INC | XCB_SIZE_HINT_P_ASPECT); - - /* NumPropSizeElements = 18 (ICCCM version 1) */ - if(length >= 18) - flags |= (XCB_SIZE_HINT_BASE_SIZE | XCB_SIZE_HINT_P_WIN_GRAVITY); - else - { - hints->base_width = 0; - hints->base_height = 0; - hints->win_gravity = 0; - } - /* get rid of unwanted bits */ - hints->flags &= flags; - - return 1; -} - -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) -{ - xcb_get_property_reply_t *reply = xcb_get_property_reply(c, cookie, e); - uint8_t ret = xcb_get_wm_size_hints_from_reply(hints, reply); - free(reply); - return ret; -} - -/* WM_NORMAL_HINTS */ - -void -xcb_set_wm_normal_hints_checked(xcb_connection_t *c, xcb_window_t window, - xcb_size_hints_t *hints) -{ - xcb_set_wm_size_hints_checked(c, window, WM_NORMAL_HINTS, hints); -} - -void -xcb_set_wm_normal_hints(xcb_connection_t *c, xcb_window_t window, - xcb_size_hints_t *hints) -{ - xcb_set_wm_size_hints(c, window, WM_NORMAL_HINTS, hints); -} - -xcb_get_property_cookie_t -xcb_get_wm_normal_hints(xcb_connection_t *c, xcb_window_t window) -{ - return xcb_get_wm_size_hints(c, window, WM_NORMAL_HINTS); -} - -xcb_get_property_cookie_t -xcb_get_wm_normal_hints_unchecked(xcb_connection_t *c, xcb_window_t window) -{ - return xcb_get_wm_size_hints_unchecked(c, window, WM_NORMAL_HINTS); -} - -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) -{ - return xcb_get_wm_size_hints_reply(c, cookie, hints, e); -} - -/* WM_HINTS */ - -uint32_t -xcb_wm_hints_get_urgency(xcb_wm_hints_t *hints) -{ - return (hints->flags & XCB_WM_HINT_X_URGENCY); -} - -void -xcb_wm_hints_set_input(xcb_wm_hints_t *hints, uint8_t input) -{ - hints->input = input; - hints->flags |= XCB_WM_HINT_INPUT; -} - -void -xcb_wm_hints_set_iconic(xcb_wm_hints_t *hints) -{ - hints->initial_state = XCB_WM_STATE_ICONIC; - hints->flags |= XCB_WM_HINT_STATE; -} - -void -xcb_wm_hints_set_normal(xcb_wm_hints_t *hints) -{ - hints->initial_state = XCB_WM_STATE_NORMAL; - hints->flags |= XCB_WM_HINT_STATE; -} - -void -xcb_wm_hints_set_withdrawn(xcb_wm_hints_t *hints) -{ - hints->initial_state = XCB_WM_STATE_WITHDRAWN; - hints->flags |= XCB_WM_HINT_STATE; -} - -void -xcb_wm_hints_set_none(xcb_wm_hints_t *hints) -{ - hints->flags &= ~XCB_WM_HINT_STATE; -} - -void -xcb_wm_hints_set_icon_pixmap(xcb_wm_hints_t *hints, xcb_pixmap_t icon_pixmap) -{ - hints->icon_pixmap = icon_pixmap; - hints->flags |= XCB_WM_HINT_ICON_PIXMAP; -} - -void -xcb_wm_hints_set_icon_mask(xcb_wm_hints_t *hints, xcb_pixmap_t icon_mask) -{ - hints->icon_mask = icon_mask; - hints->flags |= XCB_WM_HINT_ICON_MASK; -} - -void -xcb_wm_hints_set_icon_window(xcb_wm_hints_t *hints, xcb_window_t icon_window) -{ - hints->icon_window = icon_window; - hints->flags |= XCB_WM_HINT_ICON_WINDOW; -} - -void -xcb_wm_hints_set_window_group(xcb_wm_hints_t *hints, xcb_window_t window_group) -{ - hints->window_group = window_group; - hints->flags |= XCB_WM_HINT_WINDOW_GROUP; -} - -void -xcb_wm_hints_set_urgency(xcb_wm_hints_t *hints) -{ - hints->flags |= XCB_WM_HINT_X_URGENCY; -} - -void -xcb_set_wm_hints_checked(xcb_connection_t *c, xcb_window_t window, - xcb_wm_hints_t *hints) -{ - xcb_change_property_checked(c, XCB_PROP_MODE_REPLACE, window, WM_HINTS, - WM_HINTS, 32, sizeof(*hints) >> 2, hints); -} - -void -xcb_set_wm_hints(xcb_connection_t *c, xcb_window_t window, - xcb_wm_hints_t *hints) -{ - xcb_change_property(c, XCB_PROP_MODE_REPLACE, window, WM_HINTS, WM_HINTS, 32, - sizeof(*hints) >> 2, hints); -} - -xcb_get_property_cookie_t -xcb_get_wm_hints(xcb_connection_t *c, - xcb_window_t window) -{ - return xcb_get_property(c, 0, window, WM_HINTS, WM_HINTS, 0L, - XCB_NUM_WM_HINTS_ELEMENTS); -} - -xcb_get_property_cookie_t -xcb_get_wm_hints_unchecked(xcb_connection_t *c, - xcb_window_t window) -{ - return xcb_get_property_unchecked(c, 0, window, WM_HINTS, WM_HINTS, 0L, - XCB_NUM_WM_HINTS_ELEMENTS); -} - -uint8_t -xcb_get_wm_hints_from_reply(xcb_wm_hints_t *hints, - xcb_get_property_reply_t *reply) -{ - if(!reply) - return 0; - - int length = xcb_get_property_value_length(reply); - int num_elem = length / (reply->format / 8); - - if (reply->type != WM_HINTS - || reply->format != 32 - || num_elem < XCB_NUM_WM_HINTS_ELEMENTS - 1) - return 0; - - memcpy(hints, (xcb_size_hints_t *) xcb_get_property_value(reply), length); - - if(num_elem < XCB_NUM_WM_HINTS_ELEMENTS) - hints->window_group = XCB_NONE; - - return 1; -} - -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) -{ - xcb_get_property_reply_t *reply = xcb_get_property_reply(c, cookie, e); - int ret = xcb_get_wm_hints_from_reply(hints, reply); - free(reply); - return ret; -} - -/* WM_PROTOCOLS */ - -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) -{ - xcb_change_property_checked(c, XCB_PROP_MODE_REPLACE, window, wm_protocols, - ATOM, 32, list_len, list); -} - -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) -{ - xcb_change_property(c, XCB_PROP_MODE_REPLACE, window, wm_protocols, ATOM, 32, - list_len, list); -} - -xcb_get_property_cookie_t -xcb_get_wm_protocols(xcb_connection_t *c, xcb_window_t window, - xcb_atom_t wm_protocol_atom) -{ - return xcb_get_property(c, 0, window, wm_protocol_atom, ATOM, 0, UINT_MAX); -} - -xcb_get_property_cookie_t -xcb_get_wm_protocols_unchecked(xcb_connection_t *c, - xcb_window_t window, - xcb_atom_t wm_protocol_atom) -{ - return xcb_get_property_unchecked(c, 0, window, wm_protocol_atom, ATOM, 0, - UINT_MAX); -} - -uint8_t -xcb_get_wm_protocols_from_reply(xcb_get_property_reply_t *reply, xcb_get_wm_protocols_reply_t *protocols) -{ - if(!reply || reply->type != ATOM || reply->format != 32) - return 0; - - protocols->_reply = reply; - protocols->atoms_len = xcb_get_property_value_length(protocols->_reply) / (reply->format / 8); - protocols->atoms = (xcb_atom_t *) xcb_get_property_value(protocols->_reply); - - return 1; -} - -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) -{ - xcb_get_property_reply_t *reply = xcb_get_property_reply(c, cookie, e); - uint8_t ret = xcb_get_wm_protocols_from_reply(reply, protocols); - if(!ret) - free(reply); - return ret; -} - -void -xcb_get_wm_protocols_reply_wipe(xcb_get_wm_protocols_reply_t *protocols) -{ - free(protocols->_reply); -} diff --git a/icccm/xcb-icccm.pc.in b/icccm/xcb-icccm.pc.in deleted file mode 100644 index 0586560..0000000 --- a/icccm/xcb-icccm.pc.in +++ /dev/null @@ -1,11 +0,0 @@ -prefix=@prefix@ -exec_prefix=@exec_prefix@ -libdir=@libdir@ -includedir=@includedir@ - -Name: XCB ICCCM library -Description: XCB ICCCM binding -Version: @PACKAGE_VERSION@ -Requires: xcb xcb-atom xcb-property -Libs: -L${libdir} -lxcb-icccm @LIBS@ -Cflags: -I${includedir} diff --git a/icccm/xcb_icccm.h b/icccm/xcb_icccm.h deleted file mode 100644 index 938fecb..0000000 --- a/icccm/xcb_icccm.h +++ /dev/null @@ -1,916 +0,0 @@ -#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__ */ |