XSetIconName(3X11)      COMMAND REFERENCE      XSetIconName(3X11)



NAME
     XSetIconName, XGetIconName - set or get icon names

SYNOPSIS
     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.




X Version 11            1 September 1988                        1

XSetIconName(3X11)      COMMAND REFERENCE      XSetIconName(3X11)



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
















































X Version 11            1 September 1988                        2

%%index%%
na:504,102;
sy:606,991;
de:1597,1015;
di:2612,927;
se:3539,526;
%%index%%000000000097