module xcb.icccm;
/*
 * 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.
 */

import xcb.xcb;

extern (C):

/**
 * @brief TextProperty reply structure.
 */
struct xcb_icccm_get_text_property_reply_t {
	/** 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 */
	uint name_len;
	/** Property value */
	char* name;
	/** Format, may be 8, 16 or 32 */
	ubyte format;
}

/**
 * @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().
 */
ubyte 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,
	ubyte format, uint 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, ubyte format,
	uint 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.
 */
ubyte 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,
	ubyte format, uint 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, ubyte format,
	uint 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.
 */
ubyte 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, uint 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, uint list_len, const xcb_window_t* list);

/**
 * @brief WM_COLORMAP_WINDOWS structure.
 */
struct xcb_icccm_get_wm_colormap_windows_reply_t {
	/** Length of the windows list */
	uint 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;
}

/**
 * @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().
 */
ubyte 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().
 */
ubyte 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,
	ubyte format, uint 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,
	ubyte format, uint 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.
 */
ubyte 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, uint 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, uint class_len, const char* class_name);

struct xcb_icccm_get_wm_class_reply_t {
	/** 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;
}

/**
 * @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.
 */
ubyte 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().
 */
ubyte 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.
 */
ubyte 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.
 */
ubyte 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 */

enum xcb_icccm_size_hints_flags_t {
	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
}

alias XCB_ICCCM_SIZE_HINT_US_POSITION = xcb_icccm_size_hints_flags_t.XCB_ICCCM_SIZE_HINT_US_POSITION;
alias XCB_ICCCM_SIZE_HINT_US_SIZE = xcb_icccm_size_hints_flags_t.XCB_ICCCM_SIZE_HINT_US_SIZE;
alias XCB_ICCCM_SIZE_HINT_P_POSITION = xcb_icccm_size_hints_flags_t.XCB_ICCCM_SIZE_HINT_P_POSITION;
alias XCB_ICCCM_SIZE_HINT_P_SIZE = xcb_icccm_size_hints_flags_t.XCB_ICCCM_SIZE_HINT_P_SIZE;
alias XCB_ICCCM_SIZE_HINT_P_MIN_SIZE = xcb_icccm_size_hints_flags_t.XCB_ICCCM_SIZE_HINT_P_MIN_SIZE;
alias XCB_ICCCM_SIZE_HINT_P_MAX_SIZE = xcb_icccm_size_hints_flags_t.XCB_ICCCM_SIZE_HINT_P_MAX_SIZE;
alias XCB_ICCCM_SIZE_HINT_P_RESIZE_INC = xcb_icccm_size_hints_flags_t.XCB_ICCCM_SIZE_HINT_P_RESIZE_INC;
alias XCB_ICCCM_SIZE_HINT_P_ASPECT = xcb_icccm_size_hints_flags_t.XCB_ICCCM_SIZE_HINT_P_ASPECT;
alias XCB_ICCCM_SIZE_HINT_BASE_SIZE = xcb_icccm_size_hints_flags_t.XCB_ICCCM_SIZE_HINT_BASE_SIZE;
alias XCB_ICCCM_SIZE_HINT_P_WIN_GRAVITY = xcb_icccm_size_hints_flags_t.XCB_ICCCM_SIZE_HINT_P_WIN_GRAVITY;

/**
 * @brief Size hints structure.
 */
struct xcb_size_hints_t {
	/** User specified flags */
	uint flags;
	/** User-specified position */
	int x, y;
	/** User-specified size */
	int width, height;
	/** Program-specified minimum size */
	int min_width, min_height;
	/** Program-specified maximum size */
	int max_width, max_height;
	/** Program-specified resize increments */
	int width_inc, height_inc;
	/** Program-specified minimum aspect ratios */
	int min_aspect_num, min_aspect_den;
	/** Program-specified maximum aspect ratios */
	int max_aspect_num, max_aspect_den;
	/** Program-specified base size */
	int base_width, base_height;
	/** Program-specified window gravity */
	uint win_gravity;
}

/** Number of elements in this structure */
enum 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, int x, int 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, int width, int 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, int min_width, int 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, int max_width, int 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, int width_inc, int 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, int min_aspect_num, int min_aspect_den, int max_aspect_num, int 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, int base_width, int 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.
 */
ubyte 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.
 */
ubyte 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.
 */
ubyte 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).
 */
struct xcb_icccm_wm_hints_t {
	/** Marks which fields in this structure are defined */
	int flags;
	/** Does this application rely on the window manager to get keyboard
    input? */
	uint input;
	/** See below */
	int 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 */
	int icon_x, icon_y;
	/** Icon mask bitmap */
	xcb_pixmap_t icon_mask;
	/* Identifier of related window group */
	xcb_window_t window_group;
}

/** Number of elements in this structure */
enum XCB_ICCCM_NUM_WM_HINTS_ELEMENTS = 9;

/**
 * @brief WM_HINTS window states.
 */
enum xcb_icccm_wm_state_t {
	XCB_ICCCM_WM_STATE_WITHDRAWN = 0,
	XCB_ICCCM_WM_STATE_NORMAL = 1,
	XCB_ICCCM_WM_STATE_ICONIC = 3
}

alias XCB_ICCCM_WM_STATE_WITHDRAWN = xcb_icccm_wm_state_t.XCB_ICCCM_WM_STATE_WITHDRAWN;
alias XCB_ICCCM_WM_STATE_NORMAL = xcb_icccm_wm_state_t.XCB_ICCCM_WM_STATE_NORMAL;
alias XCB_ICCCM_WM_STATE_ICONIC = xcb_icccm_wm_state_t.XCB_ICCCM_WM_STATE_ICONIC;

enum xcb_icccm_wm_t {
	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)
}

alias XCB_ICCCM_WM_HINT_INPUT = xcb_icccm_wm_t.XCB_ICCCM_WM_HINT_INPUT;
alias XCB_ICCCM_WM_HINT_STATE = xcb_icccm_wm_t.XCB_ICCCM_WM_HINT_STATE;
alias XCB_ICCCM_WM_HINT_ICON_PIXMAP = xcb_icccm_wm_t.XCB_ICCCM_WM_HINT_ICON_PIXMAP;
alias XCB_ICCCM_WM_HINT_ICON_WINDOW = xcb_icccm_wm_t.XCB_ICCCM_WM_HINT_ICON_WINDOW;
alias XCB_ICCCM_WM_HINT_ICON_POSITION = xcb_icccm_wm_t.XCB_ICCCM_WM_HINT_ICON_POSITION;
alias XCB_ICCCM_WM_HINT_ICON_MASK = xcb_icccm_wm_t.XCB_ICCCM_WM_HINT_ICON_MASK;
alias XCB_ICCCM_WM_HINT_WINDOW_GROUP = xcb_icccm_wm_t.XCB_ICCCM_WM_HINT_WINDOW_GROUP;
alias XCB_ICCCM_WM_HINT_X_URGENCY = xcb_icccm_wm_t.XCB_ICCCM_WM_HINT_X_URGENCY;

enum 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.
 */
uint 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, ubyte 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.
 */
ubyte 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.
 */
ubyte 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,
	uint 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,
	uint list_len, xcb_atom_t* list);

/**
 * @brief WM_PROTOCOLS structure.
 */
struct xcb_icccm_get_wm_protocols_reply_t {
	/** Length of the atoms list */
	uint 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;
}

/**
 * @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().
 */
ubyte 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().
 */
ubyte 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);