XSetIconName() XSetIconName()
Name
XSetIconName - set the name to be displayed in a window's icon.
Synopsis
XSetIconName(display, w, icon_name)
Display *display;
Window w;
char *icon_name;
Arguments
display Specifies a connection to an X server; returned from XOpenDisplay().
w Specifies the ID of the window whose icon name is being set.
icon_name Specifies the name to be displayed in the window's icon. The name should be a NULL-terminated string. This name is returned by
any subsequent call to XGetIconName(). If the string is not in the Host Portable Character Encoding, the result is implementa-
tion-dependent.
Description
XSetIconName() is superseded by XSetWMIconName() in Release 4.
XSetIconName() sets the XA_WM_ICON_NAME property for a window. This is usually set by an application for the window manager. The name
should be short, since it is to be displayed in association with an icon.
XSetStandardProperties() (in Release 3) or XSetWMProperties() (in Release 4) also set this property.
For more information, see Volume One, Chapter 12, Interclient Communication.
Errors
BadAlloc
BadWindow
See Also
XFetchName(), XGetClassHint(), XGetIconName(), XGetIconSizes(), XGetNormalHints(), XGetSizeHints(), XGetTransientForHint(), XGetWMHints(),
XGetZoomHints(), XSetClassHint(), XSetCommand(), XSetIconSizes(), XSetNormalHints(), XSetSizeHints(), XSetTransientForHint(),
XSetWMHints(), XSetZoomHints(), XStoreName().
Xlib - Window Manager Hints XSetIconName()
