XSetNormalHints(3X11)

Name

XSetNormalHints, XGetNormalHints − set or get normal state hints

Syntax

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

Status XGetNormalHints(display, w, hints_return)
      Display *display;
      Window w;
      XSizeHints *hints_return;

Arguments

displaySpecifies the connection to the X server.

hintsSpecifies a pointer to the size hints for the window in its normal state.

hints_returnReturns the size hints for the window in its normal state.

wSpecifies the window.

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.

The XGetNormalHints function returns the size hints for a window in its normal state. It returns a nonzero status if it succeeds or zero if the application specified no normal size hints for this window.

XGetNormalHints can generate a BadWindow error.

Property

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

Museum

Related Articles