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

XWIN 3.0               Last change: 9/1/88                 .ie t

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

XWIN 3.0               Last change: 9/1/88                 .ie t

XWIN 3.0               Last change: 9/1/88                 .ie t