XSetIconName(3X11)                   BSD                    XSetIconName(3X11)



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(3X11), XSetCommand(3X11), XSetIconSizeHints(3X11),
     XSetNormalHints(3X11), XSetSizeHints(3X11), XSetStandardProperties(3X11),
     XSetTransientForHint(3X11), XSetWMHints(3X11), XSetZoomHints(3X11),
     XStoreName(3X11)
     Xlib - C Language X Interface