hpux man page for xtcreatewindow

XtCreateWindow()														  XtCreateWindow()

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
  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 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
  realize(4).

Xt - Window Manipulation													  XtCreateWindow()