xtcreatewindow(3) [debian man page]

XtCreateWindow(3)						   XT FUNCTIONS 						 XtCreateWindow(3)

NAME

       XtCreateWindow - window creation convenience function

SYNTAX

       void XtCreateWindow(Widget w, unsigned int window_class, Visual *visual, XtValueMask value_mask, XSetWindowAttributes *attributes);

ARGUMENTS

       attributes
		 Specifies the window attributes to use in the XCreateWindow call.

       value_mask
		 Specifies which attribute fields to use.

       visual	 Specifies the visual type (usually CopyFromParent).

       w	 Specifies the widget that is used to set the x,y coordinates and so on.

       window_class
		 Specifies the Xlib window class (for example, InputOutput, InputOnly, or CopyFromParent).

DESCRIPTION

       The XtCreateWindow function calls the Xlib XCreateWindow function with values from the widget structure and the passed parameters.  Then,
       it assigns the created window to the widget's window field.

       XtCreateWindow evaluates the following fields of the Core widget structure:

       o    depth

       o    screen

       o    parent -> core.window

       o    x

       o    y

       o    width

       o    height

       o    border_width

SEE ALSO

       X Toolkit Intrinsics - C Language Interface
       Xlib - C Language X Interface

X Version 11							    libXt 1.1.3 						 XtCreateWindow(3)

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()