XtCreateWindow()XtCreateWindow()NameXtCreateWindow - create widget's window.
Synopsis
void XtCreateWindow(w, window_class, visual, value_mask, attributes)
Widget w;
unsigned int window_class;
Visual *visual;
XtValueMask value_mask;
XSetWindowAttributes *attributes;
Inputs
w Specifies the widget that is to have a window created; must
be of class Core or a subclass thereof.
window_class
Specifies the Xlib window class (InputOutput, InputOnly, or
CopyFromParent).
visual Specifies the Xlib visual type (usually CopyFromParent).
value_mask Specifies which attribute fields to use.
attributes Specifies the window attributes to use in the XCreateWin‐
dow() call.
DescriptionXtCreateWindow() copies the depth, screen, x, y, width, height and bor‐
der_width fields of the core part of the specified widget into the
attributes structure. Then it passes attributes and an appropriately
modified value_mask along with the widget's display, the widget's par‐
ent's window, window_class, and visual to the Xlib function XCreateWin‐
dow(). It stores the newly created Window in the widget's core part
window field.
Usage
This is a convenience function intended for use in the realize() method
of widgets. It should never be called by an application.
Structures
The XSetWindowAttributes structure is as follows:
typedef struct {
Pixmap background_pixmap; /* background or None or ParentRelative * /
unsigned long background_pixel;/* background pixel */
Pixmap border_pixmap; /* border of the window */
unsigned long border_pixel; /* border pixel value */
int bit_gravity; /* one of bit gravity values */
int win_gravity; /* one of the window gravity values */
int backing_store; /* NotUseful, WhenMapped, Always */
unsigned long backing_planes; /* planes to be preserved if possible */
unsigned long backing_pixel; /* value to use in restoring planes */
Bool save_under; /* should bits under be saved (popups) */
long event_mask; /* set of events that should be saved */
long do_not_propagate_mask; /* set of events that should not propagate */
Bool override_redirect; /* boolean value for override-redirect */
Colormap colormap; /* colormap to be associated with window */
Cursor cursor; /* cursor to be displayed (or None) */
} XSetWindowAttributes;
/* Definitions for valuemask argument. These control which fields in
* XSetWindowAttributes structure should be used.
*/
#define CWBackPixmap (1L<<0)
#define CWBackPixel (1L<<1)
#define CWBorderPixmap (1L<<2)
#define CWBorderPixel (1L<<3)
#define CWBitGravity (1L<<4)
#define CWWinGravity (1L<<5)
#define CWBackingStore (1L<<6)
#define CWBackingPlanes (1L<<7)
#define CWBackingPixel (1L<<8)
#define CWOverrideRedirect (1L<<9)
#define CWSaveUnder (1L<<10)
#define CWEventMask (1L<<11)
#define CWDontPropagate (1L<<12)
#define CWColormap (1L<<13)
#define CWCursor (1L<<14)
See Alsorealize(4).
Xt - Window Manipulation XtCreateWindow()
