X Version 11 (1 September 1988) XSetIconName(XS)
NAME
XSetIconName, XGetIconName - set or get icon names
SYNTAX
XSetIconName(display, w, icon_name)
Display *display;
Window w;
char *icon_name;
Status XGetIconName(display, w, icon_name_return)
Display *display;
Window w;
char **icon_name_return;
ARGUMENTS
display Specifies the connection to the X server.
icon_name Specifies the icon name, which should be a null-
terminated string.
icon_name_return
Returns a pointer to the window's icon name, which
is a null-terminated string.
w Specifies the window.
DESCRIPTION
The XSetIconName function sets the name to be displayed in a
window's icon.
XSetIconName can generate BadAlloc and BadWindow errors.
The XGetIconName function returns the name to be displayed
in the specified window's icon. If it succeeds, it returns
nonzero; otherwise, if no icon name has been set for the
window, it returns zero. If you never assigned a name to
the window, XGetIconName sets icon_name_return to NULL.
When finished with it, a client must free the icon name
string using XFree.
XGetIconName can generate a BadWindow error.
PROPERTY
WM_ICON_NAME
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(XS), XSetCommand(XS), XSetIconSizeHints(XS),
XSetNormalHints(XS), XSetSizeHints(XS),
XSetStandardProperties(XS), XSetTransientForHint(XS),
XSetWMHints(XS), XSetZoomHints(XS), XStoreName(XS)
Xlib - C Language X Interface
(printed 2/12/90) (1 September 1988) XSetIconName(XS)