NAME

XtCreateWindow − 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

wSpecifies 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). 

visualSpecifies the Xlib visual type (usually CopyFromParent). 

value_maskSpecifies which attribute fields to use. 

attributesSpecifies the window attributes to use in the XCreateWindow() call. 

DESCRIPTION

XtCreateWindow() copies the depth, screen, x, y, width, height and border_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 parent’s window, window_class, and visual to the Xlib function XCreateWindow().  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 ALSO

realizeUNIX SYSTEM V/68 and V/88 Release 4.