


XAllocIconSize(3X11)					 XAllocIconSize(3X11)
X11R5									X11R5



NAME
  XAllocIconSize, XSetIconSizes, XGetIconSizes,	XIconSize - allocate icon
  size structure and set or read a window's WM_ICON_SIZES property

SYNTAX
  XIconSize *XAllocIconSize()

  XSetIconSizes(_d_i_s_p_l_a_y, _w, _s_i_z_e__l_i_s_t, _c_o_u_n_t)
	Display	*_d_i_s_p_l_a_y;
	Window _w;
	XIconSize *_s_i_z_e__l_i_s_t;
	int _c_o_u_n_t;

  Status XGetIconSizes(_d_i_s_p_l_a_y,	_w, _s_i_z_e__l_i_s_t__r_e_t_u_r_n, _c_o_u_n_t__r_e_t_u_r_n)
	Display	*_d_i_s_p_l_a_y;
	Window _w;
	XIconSize **_s_i_z_e__l_i_s_t__r_e_t_u_r_n;
	int *_c_o_u_n_t__r_e_t_u_r_n;

ARGUMENTS

  _d_i_s_p_l_a_y   Specifies the connection to	the X server.

  _c_o_u_n_t	    Specifies the number of items in the size list.

  _c_o_u_n_t__r_e_t_u_r_n
	    Returns the	number of items	in the size list.

  _s_i_z_e__l_i_s_t Specifies the size list.

  _s_i_z_e__l_i_s_t__r_e_t_u_r_n
	    Returns the	size list.

  _w	    Specifies the window.

DESCRIPTION
  The _X_A_l_l_o_c_I_c_o_n_S_i_z_e function allocates	and returns a pointer to a _X_I_c_o_n_S_i_z_e
  structure.  Note that	all fields in the _X_I_c_o_n_S_i_z_e structure are initially
  set to zero.	If insufficient	memory is available, _X_A_l_l_o_c_I_c_o_n_S_i_z_e returns
  NULL.	 To free the memory allocated to this structure, use _X_F_r_e_e.

  The _X_S_e_t_I_c_o_n_S_i_z_e_s function is	used only by window managers to	set the	sup-
  ported icon sizes.

  _X_S_e_t_I_c_o_n_S_i_z_e_s	can generate _B_a_d_A_l_l_o_c and _B_a_d_W_i_n_d_o_w errors.

  The _X_G_e_t_I_c_o_n_S_i_z_e_s function returns zero if a window manager has not set
  icon sizes; otherwise, it returns nonzero.  _X_G_e_t_I_c_o_n_S_i_z_e_s should be called
  by an	application that wants to find out what	icon sizes would be most
  appreciated by the window manager under which	the application	is running.
  The application should then use _X_S_e_t_W_M_H_i_n_t_s to supply	the window manager
  with an icon pixmap or window	in one of the supported	sizes.	To free	the
  data allocated in size_list_return, use _X_F_r_e_e.

  _X_G_e_t_I_c_o_n_S_i_z_e_s	can generate a _B_a_d_W_i_n_d_o_w error.



PROPERTIES

  WM_ICON_SIZES
	    The	window manager may set this property on	the root window	to
	    specify the	icon sizes it supports.	 The C type of this property
	    is _X_I_c_o_n_S_i_z_e.

STRUCTURES
  The _X_I_c_o_n_S_i_z_e	structure contains:

  typedef struct {
	  int min_width, min_height;
	  int max_width, max_height;
	  int width_inc, height_inc;
  } XIconSize;

  The width_inc	and height_inc members define an arithmetic progression	of
  sizes	(minimum to maximum) that represent the	supported icon sizes.

DIAGNOSTICS

  _B_a_d_A_l_l_o_c  The	server failed to allocate the requested	resource or server
	    memory.

  _B_a_d_W_i_n_d_o_w A value for	a Window argument does not name	a defined Window.

SEE ALSO
  XAllocClassHint(3X11), XAllocSizeHints(3X11),	XAllocWMHints(3X11),
  XFree(3X11), XSetCommand(3X11), XSetTransientForHint(3X11),
  XSetTextProperty(3X11), XSetWMClientMachine(3X11),
  XSetWMColormapWindows(3X11), XSetWMIconName(3X11), XSetWMName(3X11),
  XSetWMProperties(3X11), XSetWMProtocols(3X11),
  XStringListToTextProperty(3X11)
  _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
































