X Version 11 (1 September 1988) XSetNormalHints(XS)
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
display Specifies the connection to the X server.
hints Specifies a pointer to the size hints for the
window in its normal state.
hints_return
Returns the size hints for the window in its
normal state.
w Specifies 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.
SEE ALSO
XSetCommand(XS), XSetIconName(XS), XSetIconSizeHints(XS),
XSetSizeHints(XS), XSetStandardProperties(XS),
XSetWMHints(XS), XSetZoomHints(XS), XStoreName(XS)
Xlib - C Language X Interface
(printed 2/12/90) (1 September 1988) XSetNormalHints(XS)