XtCreateWin(3x) — HPUX 9.05

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)

Museum