XSetNormalHints(3X) XSetNormalHints(3X)
NAME
XSetNormalHints, XGetNormalHints - set or get normal
state hints
SYNOPSIS
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
- 1 -
XSetNormalHints(3X) XSetNormalHints(3X)
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(3X11), XSetIconName(3X11),
XSetIconSizeHints(3X11), XSetSizeHints(3X11),
XSetStandardProperties(3X11), XSetWMHints(3X11),
XSetZoomHints(3X11), XStoreName(3X11)
Xlib Programming Manual
- 2 -