XSetNormalHints

This function has been superseded by XSetWMNormalHints().

Syntax

XSetNormalHints(display, w, hints)
      Display *display;
      Window w;
      XSizeHints *hints;

Arguments

display Specifies the connection to the X server.
w Specifies the window.
hints Specifies a pointer to the size hints for the window in its normal state.

Description

The XSetNormalHints() function sets the size hints structure for the specified window. Applications use XSetNormalHints() to inform the window manager of the size or position desirable for that window. In addition, an application that wants to move or resize itself should call XSetNormalHints() and specify its new desired location and size as well as making direct Xlib calls to move or resize. This is because window managers may ignore redirected configure requests, but they pay attention to property changes.

To set size hints, an application not only must assign values to the appropriate members in the hints structure but also must set the flags member of the structure to indicate which information is present and where it came from. A call to XSetNormalHints() is meaningless, unless the flags member is set to indicate which members of the structure have been assigned values.

XSetNormalHints() can generate BadAlloc and BadWindow errors.

Syntax

Diagnostics

BadAlloc The server failed to allocate the requested source or server memory.
BadWindow A value for a Window argument does not name a defined Window.

See also

XSetWMNormalHints(), "Compatibility Functions".
Christophe Tronche, ch@tronche.com