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

displaySpecifies a connection to an X server; returned from XOpenDisplay(). 

wSpecifies the ID of the window whose icon name is being set. 

icon_nameSpecifies 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 implementation-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 4) or XSetWMProperties() (in Release 4) also set this property. 

For more information, see Volume One, Chapter 10, 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 Reference Manual