XAllocWMHints()XAllocWMHints()NameXAllocWMHints – allocate an XWMHints structure.
Synopsis
XWMHints *XAllocWMHints( )
Returns
The allocated structure.
Availability
Release 4 and later.
Description
The XAllocWMHints() function allocates and returns a pointer to an
XWMHints structure, for use in calling XSetWMProperties(),
XSetWMHints(), or XGetWMHints(). Note that all fields in the XWMHints
structure are initially set to zero. If insufficient memory is avail‐
able, XAllocWMHints() returns NULL. To free the memory allocated to
this structure, use XFree().
The purpose of this function is to avoid compiled-in structure sizes,
so that object files will be binary compatible with later releases that
may have new members added to structures.
For more information, see Volume One, Chapter 12, Interclient Communi‐
cation.
Structures
typedef struct {
long flags; /* marks which fields in this structure are defined */
Bool input; /* does this application rely on the window manager
to get keyboard input? */
int initial_state; /* see below */
Pixmap icon_pixmap; /* pixmap to be used as icon */
Window icon_window; /* window to be used as icon */
int icon_x, icon_y; /* initial position of icon */
Pixmap icon_mask; /* pixmap to be used as mask for icon_pixmap */
XID window_group; /* id of related window group */
/* this structure may be extended in the future */
} XWMHints;
See AlsoXGetWMHints(), XSetWMHints(), XSetWMProperties().
Xlib - Window Manager Hints XAllocWMHints()