Name

XSetWMHints, XGetWMHints − set or get window manager hints

Syntax

XSetWMHints(display, w, wmhints)
      Display *display;
      Window w;
      XWMHints *wmhints;
 

XWMHints *XGetWMHints(display, w)
      Display *display;
      Window w;

Arguments

displaySpecifies the connection to the X server. 

wSpecifies the window. 

wmhintsSpecifies a pointer to the window manager hints. 

Description

The XSetWMHints function sets the window manager hints that include icon information and location, the initial state of the window, and whether the application relies on the window manager to get keyboard input.

XSetWMHints can generate BadAlloc and BadWindow errors.

The XGetWMHints function reads the window manager hints and returns NULL if no WM_HINTS property was set on the window or a pointer to a XWMHints structure if it succeeds. When finished with the data, free the space used for it by calling XFree.

XGetWMHints can generate a BadWindow error.

Property

WM_HINTS

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), XSetIconName(3X11), XSetIconSizeHints(3X11), XSetNormalHints(3X11), XSetSizeHints(3X11), XSetStandardProperties(3X11), XSetTransientForHint(3X11), XSetZoomHints(3X11), XStoreName(3X11)
Guide to the Xlib Library