xseticonname(3) [hpux man page]

XSetIconName()															    XSetIconName()

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
  display   Specifies a connection to an X server; returned from XOpenDisplay().

  w	    Specifies the ID of the window whose icon name is being set.

  icon_name Specifies  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  implementa-
	    tion-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 3) or XSetWMProperties() (in Release 4) also set this property.

  For more information, see Volume One, Chapter 12, 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 - Window Manager Hints													    XSetIconName()

XGetIconName()															    XGetIconName()

Name
  XGetIconName - 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 argu-
	    ment to NULL.  When finished with it, a client must free the icon name string using XFree().

Returns
  Zero on failure, non-zero on success.

Description
  XGetIconName() is superseded by XGetWMIconName() in Release 4.  XGetIconName() 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 Communication.

Errors
  BadWindow

See Also
  XFetchName(), XGetClassHint(), XGetIconSizes(), XGetNormalHints(), XGetSizeHints(), XGetTransientForHint(), XGetWMHints(), XGetZoomHints(),
  XSetClassHint(), XSetCommand(), XSetIconName(), XSetIconSizes(), XSetNormalHints(), XSetSizeHints(), XSetTransientForHint(), XSetWMHints(),
  XSetZoomHints(), XStoreName().

Xlib - Window Manager Hints													    XGetIconName()