NAME

XAllocWMHints − allocate an XWMHints structure. 

Synopsis

XWMHints *XAllocWMHints()

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 available, 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 10, Interclient Communication. 

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 Also

XGetWMHints(), XSetWMHints(), XSetWMProperties(). 

Copyright O’Reilly & Assoc.  —