XSetIconSizeHints(3X) XSetIconSizeHints(3X)
NAME
XSetIconSizes, XGetIconSizes - set or get icon size
hints
SYNOPSIS
XSetIconSizes(display, w, size_list, count)
Display *display;
Window w;
XIconSize *size_list;
int count;
Status XGetIconSizes(display, w, size_list_return,
count_return)
Display *display;
Window w;
XIconSize **size_list_return;
int *count_return;
ARGUMENTS
display Specifies the connection to the X server.
count Specifies the number of items in the size
list.
count_return
Returns the number of items in the size list.
size_list Specifies a pointer to the size list.
size_list_return
Returns a pointer to the size list.
w Specifies the window.
DESCRIPTION
The XSetIconSizes function is used only by window
managers to set the supported icon sizes.
XSetIconSizes can generate BadAlloc and BadWindow
errors.
The XGetIconSizes function returns zero if a window
manager has not set icon sizes or nonzero otherwise.
XGetIconSizes 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 XSetWMHints 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
XFree.
- 1 -
XSetIconSizeHints(3X) XSetIconSizeHints(3X)
XGetIconSizes can generate a BadWindow error.
PROPERTY
WM_ICON_SIZE
DIAGNOSTICS
BadAlloc The server failed to allocate the requested
resource or server memory.
BadWindow A value for a Window argument does not name a
defined Window.
SEE ALSO
XSetClassHint(3X11), XSetCommand(3X11),
XSetIconName(3X11), XSetNormalHints(3X11),
XSetSizeHints(3X11), XSetStandardProperties(3X11),
XSetTransientForHint(3X11), XSetWMHints(3X11),
XSetZoomHints(3X11), XStoreName(3X11)
Xlib Programming Manual
- 2 -