NAME

XSetIconName, XGetIconName − set or get icon names

SYNTAX

XSetIconName(display, w, icon_name)
      Display ∗display;
      Window w;
      char ∗icon_name;

int XGetIconName(display, w, icon_name_return)
      Display ∗display;
      Window w;
      char ∗∗icon_name_return;

ARGUMENTS

displaySpecifies the connection to the X server. 

icon_nameSpecifies the name to be displayed in the window’s icon. 

icon_name_return
Returns a pointer to the name to be displayed in the window’s icon. The name will be a null-terminated string.

wSpecifies the window ID. 

DESCRIPTION

The XSetIconName function sets the name to be displayed in a window’s icon. .PN XSetIconName can generate BadAlloc and BadWindow errors.

The XGetIconName function obtains the window name to be displayed in its icon and either returns a nonzero if it succeeds or zero if it fails (for example, if no icon name has been set for the argument window). .PN 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(3X), XSetCommand(3X), XSetIconSizeHints(3X), XSetNormalHints(3X), XSetSizeHints(3X), XSetStandardProperties(3X), XSetTransientForHint(3X), XSetWMHints(3X), XSetZoomHints(3X), XStoreName(3X)
Xlib − C Language X Interface

1 March 1988