Volume 7B: XView Reference Manual

WIN_COLLAPSE_EXPOSURES

Collapses contiguous multiple Exposure (and GraphicsExpose) events destined for the same

window that are grouped by the count field in the X Expose event.

Argument: Bool

Default:

TRUE

Procs: create, get, set

Objects: Xv_Window

See Also: 5.3

WIN_COLUMN_GAP

Specifies the gap between columns in the window.

Argument: int

Default: 0

Procs: create, get, set

Objects: Xv_Window

WIN_COLUMN_WIDTH

Specifies the width of a column in the window.

Argument: int

Default: Font’s default width

Procs: create, get, set

Objects: Xv_Window

WIN_COLUMNS

Specifies the window’s width (including left and right margins) in columns relative to the width of the

window’s font.

WIN_COLUMNS is not a valid xv_create() attribute for a Textsw. Issue a separate

xv_set() call after the xv_create() in order to set this attribute on a Textsw.

Argument: int

Default: Varies based on font, typically 80 columns

Procs: create, get, set

Objects: Xv_Window

WIN_CONSUME_EVENT

Specifies that the window will accept an event of type specified. The event is appended to the current

input mask.

Argument: Event code (defined in <xview/win_input.h>)

Default: Varies from package to package

Procs: create, get, set

Objects: Xv_Window

See Also: 6.3.2, 5.7.1,

WIN_CONSUME_X_EVENT_MASK,

WIN_CONSUME_EVENTS,WIN_IGNORE_EVENT, WIN_IGNORE_EVENTS,

WIN_X_EVENT_MASK

WIN_CONSUME_EVENTS

Specifies a

NULL-terminated list of event types that this window accepts. The event is appended to the

current input mask.

Argument: List of XView events

Default: Varies from package to package

Procs: create, set

Objects: Xv_Window

See Also: 6.3.2,

WIN_CONSUME_X_EVENT_MASK, WIN_CONSUME_EVENT,

WIN_IGNORE_EVENT, WIN_IGNORE_EVENTS, WIN_X_EVENT_MASK

XView Attributes

XView Attributes 151

WIN_CONSUME_X_EVENT_MASK

The input mask is specified using X event masks found in <X11/X.h>. The event is appended to the

current input mask.

Argument: unsigned long

Default: Varies from package to package

Procs: create, get, set

Objects: Xv_Window

See Also: 6.3.1,

WIN_CONSUME_EVENT, WIN_CONSUME_X_EVENTS, WIN_IGNORE_EVENT,

WIN_IGNORE_EVENTS, WIN_X_EVENT_MASK

WIN_CURSOR

Specifies the window’s cursor. You must supply the handle of an XView window as the parent

parameter when getting WIN_CURSOR. Getting WIN_CURSOR on the root window returns NULL.

Argument: Xv_Cursor

Default: Default X server cursor

Procs: create, get, set

Objects: Xv_Window

Usage:

default_cursor = (Xv_cursor)xv_get(paint_win, WIN_CURSOR);

xv_set(paint_win, WIN_CURSOR, default_cursor, NULL);

WIN_DEPTH

This attribute is obsolete. Use

XV_DEPTH instead. Specifies the pixel depth of the window.

Argument: int

Default: Function of the screen

Procs: create, get

Objects: Xv_Window

See Also: 21.8, 2.4.2

WIN_DYNAMIC_VISUAL

This attribute is obsolete. Use the attribute XV_VISUAL to specify the visual used in the creation of

the window or colormap segment.

Argument: Bool

Default:

FALSE

Procs: create

Objects: Xv_Window

WIN_EVENT_PROC

Specifies a callback procedure where window events are delivered.

Argument: void (*event_proc)()

Default: None

Procs: create, get, set

Objects: Xv_Window

Callback:

void

event_proc(window, event, arg)

Xv_Window window;

Event *event;

Notify_arg arg;

See Also: Chapter 20, The Notifier, in XView Programming Manual.

152 XView Reference Manual

WIN_FIT_HEIGHT

Causes the window to shrink or expand its height according to the window’s contents leaving a mar-

gin specified by the value given. Typically used with panels to fit panel items.

Argument: int

Default: Depends on window size

Procs: create, get, set

Objects: Xv_Window

See Also: window_fit() macro in Section 3, Procedures and Macros.

WIN_FIT_WIDTH

Causes the window to shrink or expand its width according to the window’s contents leaving a margin

specified by the value given.

Argument: int

Default: Depends on window size

Procs: create,get,set

Objects: Xv_Window

See Also window_fit() macro in Section 3, Procedures and Macros

WIN_FOREGROUND_COLOR

Specifies the foreground color of a window as an index into the colormap segment associated with the

window.

Argument: int

Default: size –1 (where size is the number of colors in the colormap segment associated with

the window)

Procs: create, get, set

Objects: Xv_Window

See Also: 4.7, 21.3.1.1,

WIN_CMS, WIN_BACKGROUND_COLOR

WIN_FRAME

Returns the window’s frame.

Return Type: Frame

Default: N/A

Procs: get

Objects: Xv_Window

WIN_FRONT

Indicates that the window should move to the front of the stacking order. Setting this attribute does

not map the window. Use

XV_SHOW to raise and map a window.

Argument: No value

Procs: create, set

Objects: Xv_Window

WIN_GRAB_ALL_INPUT

Specifies that the window will get all events regardless of location of the pointer. Performs a grab of

the keyboard and the pointer.

Argument: Bool

Default:

FALSE

Procs: set, create

Objects: Xv_Window

See Also: 6.6.1.2,

FULLSCREEN attributes

XView Attributes

XView Attributes 153

WIN_HORIZONTAL_SCROLLBAR

This attribute is obsolete. Use OPENWIN_HORIZONTAL_SCROLLBAR instead. It is a handle to the hori-

zontal scrollbar for that window.

Argument: Scrollbar

Default:

NULL

Procs: create, get, set

Objects: Xv_Window

WIN_IGNORE_EVENT

Specifies that the window will not receive this event. (Certain events cannot be ignored.)

Argument: XView event code (see <xview/win_input.h>)

Default: None

Procs: create, set

Objects: Xv_Window

See Also: 6.3.2,

WIN_CONSUME_EVENT, WIN_CONSUME_X_EVENT_MASK,

WIN_CONSUME_EVENTS, WIN_IGNORE_EVENTS

WIN_IGNORE_EVENTS

Specifies a NULL-terminated list of events that this window will not receive. (Certain events cannot be

ignored.)

Argument: List of event codes (see <xview/win_input.h>)

Default: None

Procs: set, create

Objects: Xv_Window

See Also: 6.3.2,

WIN_CONSUME_EVENT, WIN_CONSUME_X_EVENT_MASK,

WIN_CONSUME_EVENTS, WIN_IGNORE_EVENT

WIN_IGNORE_X_EVENT_MASK

Prevents the specified event masks from being delivered to the event handler. The input mask is

specified using X event masks found in <X11/X.h>.

Argument: unsigned long

Default: Varies from package to package

Procs: create, get, set

Objects: Xv_Window

See Also: 6.3.1,

WIN_CONSUME_X_EVENT_MASK, WIN_EVENT_PROC,

WIN_IGNORE_EVENT, WIN_IGNORE_EVENTS, WIN_X_EVENT_MASK

WIN_INHERIT_COLORS

This attribute specifies whether the window should inherit the colors used by its parent. If

TRUE, the

window will inherit the

WIN_CMS, XV_VISUAL, WIN_FOREGROUND_COLOR, and WIN_

BACKGROUND_COLOR attributes of its parent. If FALSE, it will use the defaults for all of these attri-

butes.

Argument: Bool

Default:

TRUE

Procs: create,get,set

Objects: Xv_Window

154 XView Reference Manual

WIN_INPUT_MASK

Specifies the window’s input mask. This overwrites the current mask.

Argument: Inputmask *

Default: Varies from package to package

Procs: create, get, set

Objects: Xv_Window

See Also: 6.8

WIN_INPUT_ONLY

Specifies that a window is an input only window; although it has other window properties, it cannot

be drawn into.

Argument: No value

Default: Input/Ouptut Window

Procs: create

Objects: Xv_Window

WIN_IS_CLIENT_PANE

When used with xv_create(), the attribute has no value; using the attribute sets it to TRUE. When

used, the window is considered to be an OPEN LOOK GUI application-specific pane which can over-

ride resources, such as fonts. Currently, the only packages that support this are text and

tty/term.

Argument: Bool

Default:

FALSE

Procs: create, get

Objects: Xv_Window

WIN_KBD_FOCUS

This attribute is for SunView compatibility. For more information, refer to the manual Converting

SunView Applications.

WIN_MAP

Indicates whether to map or unmap the window. Setting this attribute to

TRUE maps the window with-

out changing the stacking order. This does not imply raised (to the top of the window tree). Use

XV_SHOW

to raise and map a window.

Argument: Bool

Default:

FALSE

Procs: create, get, set

Objects: Xv_Window

See Also:

WIN_FRONT, XV_SHOW

WIN_MENU

This attribute is obsolete. The window manager now specifies the window’s menu.

WIN_MESSAGE_DATA

Used to access the data portion of a window’s client message.

Return Type: char

Procs: get

Objects: Xv_Window

See Also: 6.7.1,

WIN_MESSAGE_FORMAT, WIN_MESSAGE_TYPE

XView Attributes

XView Attributes 155