WindowRec(D4nfb)

WindowRec -- Structure for defining the characteristics of a window

Synopsis

#include "windowstr.h"

Description

This structure, in conjunction with the WindowOptRec structure, defines the basic properties of a given window on a given screen.

Structure definition

typedef struct _Window {
    DrawableRec		drawable;
    WindowPtr		parent;		/* ancestor chain */
    WindowPtr		nextSib;	/* next lower sibling */
    WindowPtr		prevSib;	/* next higher sibling */
    WindowPtr		firstChild;	/* top-most child */
    WindowPtr		lastChild;	/* bottom-most child */
    RegionRec		clipList;	/* clipping rectangle for output */
    RegionRec		borderClip;	/* NotClippedByChildren + border */
    union _Validate	*valdata;
    RegionRec		winSize;
    RegionRec		borderSize;
    DDXPointRec		origin;		/* position relative to parent */
    unsigned short	borderWidth;
    unsigned short	deliverableEvents;
    Mask		eventMask;
    PixUnion		background;
    PixUnion		border;
    pointer		backStorage;	/* null when BS disabled */
    WindowOptPtr	optional;
    unsigned		backgroundState:2; /* None, Relative, Pixel, Pixmap */
    unsigned		borderIsPixel:1;
    unsigned		cursorIsNone:1;	/* else real cursor (might inherit) */
    unsigned		backingStore:2;
    unsigned		saveUnder:1;
    unsigned		DIXsaveUnder:1;
    unsigned		bitGravity:4;
    unsigned		winGravity:4;
    unsigned		overrideRedirect:1;
    unsigned		visibility:2;
    unsigned		mapped:1;
    unsigned		realized:1;	/* ancestors are all mapped */
    unsigned		viewable:1;	/* realized && InputOutput */
    unsigned		dontPropagate:3;/* index into DontPropagateMasks */
    unsigned		forcedBS:1;	/* system-supplied backingStore */
    DevUnion		*devPrivates;
} WindowRec;

Structure members

WindowRec is used to define the following:

the DrawableRec structure for the window
the place of the window in the window hierarchy
the parts of the window currently visable on the screen
the extent and border of the window
the border width
the window's parentage
the extents of the window parts where drawing can occur
events that should be propagated up the window tree
whether the window is viewable, mapped, or realized.
whether or not event redirection can be overridden in the window
bit and window gravity information
pointers to WindowOptRec structures
if implemented, window backing store information
pixmap or color information used to fill borders and backgrounds
event types of concern to the window

Version applicability

This structure is supported for NFB drivers on all releases of SCO OpenServer 5, SVR5, and AIX 5L.

References

ScreenRec(D4nfb) VisualRec(D4nfb)