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

displaySpecifies the connection to the X server. 

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

wSpecifies the window. 

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

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

September 29, 2021