XGetWMNormalHints()XGetWMNormalHints()NameXGetWMNormalHints – read a window's XA_WM_NORMAL_HINTS property.
Synopsis
Status XGetWMNormalHints(display, w, hints_return, supplied_return)
Display *display;
Window w;
XSizeHints *hints_return;
long *supplied_return;
Arguments
display Specifies a connection to an X server; returned from
XOpenDisplay().
w Specifies the window.
hints_return
Returns the size hints for the window in its normal state.
supplied_return
Returns the hints that were supplied by the user.
Returns
Zero on failure, non-zero on success.
Availability
Release 4 and later.
DescriptionXGetWMNormalHints() returns the size hints stored in the XA_WM_NOR‐
MAL_HINTS property on the specified window. If the property is of type
XA_WM_SIZE_HINTS, of format 32, and is long enough to contain either an
old (pre-ICCCM) or new size hints structure, XGetWMNormalHints() sets
the various fields of the XSizeHints structure, sets the sup‐
plied_return argument to the list of fields that were supplied by the
user (whether or not they contained defined values) and returns a non-
zero status. XGetWMNormalHints() returns a zero status if the applica‐
tion specified no normal size hints for this window.
XGetWMNormalHints() supersedes XGetNormalHints().
If XGetWMNormalHints() returns successfully and a pre-ICCCM size hints
property is read, the supplied_return argument will contain the follow‐
ing bits:
(USPosition USSize PPosition PSize PMinSize PMaxSize PResizeInc PAspect)
If the property is large enough to contain the base size and window
gravity fields as well, the supplied argument will also contain the
following bits:
(PBaseSize PWinGravity)
This function is normally used only by a window manager.
For more information, see Volume One, Chapter 12, Interclient Communi‐
cation.
Structures
typedef struct {
long flags; /* marks which fields in this structure are defined */
int x, y; /* obsolete for new window mgrs, but clients */
int width, height; /* should set so old wm's don't mess up */
int min_width, min_height;
int max_width, max_height;
int width_inc, height_inc;
struct {
int x; /* numerator */
int y; /* denominator */
} min_aspect, max_aspect;
int base_width, base_height; /* added by ICCCM version 1 */
int win_gravity; /* added by ICCCM version 1 */
} XSizeHints;
Errors
BadWindow
See AlsoXAllocSizeHints(), XGetWMSizeHints(), XSetWMNormalHints(), XSetWMProp‐
erties(), XSetWMSizeHints().
Xlib - Window Manager Hints XGetWMNormalHints()
