XGetIconName()XGetIconName()NameXGetIconName – get the name to be displayed in an icon.
Synopsis
Status XGetIconName(display, w, icon_name_return)
Display *display;
Window w;
char **icon_name_return;
Arguments
display Specifies a connection to an X server; returned from
XOpenDisplay().
w Specifies the ID of the window whose icon name you want to
learn.
icon_name_return
Returns a pointer to the name to be displayed in the window's
icon. The name is a NULL-terminated string. If the data
returned by the server is in the Latin Portable Character
Encoding, then the returned string is in the Host Portable
Character Encoding. Otherwise, the result is implementation-
dependent. If a name hasn't been assigned to the window,
XGetIconName() sets this argument to NULL. When finished
with it, a client must free the icon name string using
XFree().
Returns
Zero on failure, non-zero on success.
DescriptionXGetIconName() is superseded by XGetWMIconName() in Release 4. XGetI‐
conName() reads the icon name property of a window. This function is
primarily used by window managers to get the name to be written in a
window's icon when they need to display that icon. XGetIconName()
returns a non-zero Status if it succeeds, and zero if no icon name has
been set for the argument window.
For more information, see Volume One, Chapter 12, Interclient Communi‐
cation.
Errors
BadWindow
See AlsoXFetchName(), XGetClassHint(), XGetIconSizes(), XGetNormalHints(),
XGetSizeHints(), XGetTransientForHint(), XGetWMHints(), XGet‐
ZoomHints(), XSetClassHint(), XSetCommand(), XSetIconName(), XSetIcon‐
Sizes(), XSetNormalHints(), XSetSizeHints(), XSetTransientForHint(),
XSetWMHints(), XSetZoomHints(), XStoreName().
Xlib - Window Manager Hints XGetIconName()