NAME

XStoreName, XFetchName − set or get window names

SYNTAX

XStoreName(display, w, window_name)
      Display ∗display;
      Window w;
      char ∗window_name;

int XFetchName(display, w, window_name_return)
      Display ∗display;
      Window w;
      char ∗∗window_name_return;

ARGUMENTS

displaySpecifies the connection to the X server. 

wSpecifies the window ID. 

window_name
Specifies the name of the window.

window_name_return
Returns a pointer to the window name, which will be a null-terminated string.

DESCRIPTION

The XStoreName function assigns the name passed to window_name to the specified window. .PN XStoreName can generate BadAlloc and BadWindow errors.

The XFetchName function obtains a window name and returns either a nonzero if it succeeds or zero if it fails (for example, if no name has been set for the argument window). .PN XFetchName can generate a BadWindow error.

PROPERTY

WM_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

XSetCommand(3X), XSetIconName(3X), XSetIconSizeHints(3X), XSetNormalHints(3X), XSetSizeHints(3X), XSetStandardProperties(3X), XSetWMHints(3X), XSetZoomHints(3X)
Xlib − C Language X Interface

1 March 1988