Volume 7B: XView Reference Manual

TEXTSW_MULTI_CLICK_TIMEOUT

Specifies the maximum number of milliseconds between successive mouse clicks to still have the

clicks considered a multi-click.

Argument: int

Default: 390

Procs: create, get, set

Objects: Textsw

TEXTSW_NOTIFY_PROC

Names a notify procedure.

Argument: void (*notify_proc) ()

Default:

NULL

Procs: create, set

Objects: Textsw

Callback:

void

notify_proc(textsw, avlist)

Textsw textsw

Attr_avlist avlist

Notify procedure installed by application using

TEXTSW_NOTIFY_PROC.

See Also: 8.12

TEXTSW_READ_ONLY

If TRUE

, prevents editing of the displayed text. If another file is loaded in, read-only status is turned

off again.

Argument: Bool

Default:

FALSE

Procs: create, get, set

Objects: Textsw

TEXTSW_STATUS

If set, specifies the address of a variable of type Textsw_status. A value that reflects what hap-

pened during the call to xv_create is then written into it. Note that this attribute must appear in the

attribute list before the operation whose status you want to determine.

Argument: Textsw_status *

Default: None

Procs: create

Objects: Textsw

See Also: 8.2

TEXTSW_STORE_CHANGES_FILE

Controls whether the target filename given to textsw_store() to save the current contents to a

file changes the name of the file being edited (

TEXTSW_FILE).

Argument: Bool

Default:

TRUE

Procs: create, set

Objects: Textsw

See Also: 8.5.1

146 XView Reference Manual

TEXTSW_SUBMENU_EDIT

Returns the submenu associated with the text pane menu Edit submenu.

Argument: Menu

Procs: get

Objects: Textsw

TEXTSW_SUBMENU_FILE

Returns the submenu associated with the text pane menu File submenu.

Argument: Menu

Procs: get

Objects: Textsw

TEXTSW_SUBMENU_FIND

Returns the submenu associated with the text pane menu Find submenu.

Argument: Menu

Procs: get

Objects: Textsw

TEXTSW_SUBMENU_VIEW

Returns the submenu associated with the text pane menu View submenu.

Argument: Menu

Procs: get

Objects: Textsw

TEXTSW_UPPER_CONTEXT

Specifies the minimum number of lines to maintain between the start of the selection and top of view.

A value of –1 means defeat the normal actions.

Argument: int

Default: 2

Procs: create, get, set

Objects: Textsw

TTY_ARGV

The command, specified as an argument vector, that the tty subwindow executes. Using the value

TTY_ARGV_DO_NOT_FORK

lets a user start a tty subwindow without forking off a shell.

Argument: char**

Default: None

Procs: create, set

Objects: Textsw

See Also: 9.4, 9.1

TTY_CONSOLE

If

TRUE, tty subwindow grabs console output.

Argument: Bool

Default:

FALSE

Procs: set, create

Objects: Tty

XView Attributes

XView Attributes 147

TTY_PAGE_MODE

If TRUE, output will stop after each page.

Argument: Bool

Default:

FALSE

Procs: create, get, set

Objects: Tty

TTY_PID

The process ID of the program being run in the tty subwindow.

Argument: int

Default: None

Procs: create, get, set

Objects: Tty

See Also: 9.3

TTY_QUIT_ON_CHILD_DEATH

If TRUE, window_done is called on the parent frame of the tty window when its child terminates.

Argument: Bool

Default:

FALSE

Procs: set, create

Objects: Tty

See Also: 9.3

TTY_TTY_FD

Gets the file descriptor of the pseudo-tty associated with the tty subwindow.

Argument: int

Procs: get

Objects: Tty

See Also: 9.4

WIN_ALARM

Rings the bell for that window.

Argument: No value

Default: off

Procs: set, create

Objects: Xv_Window

See Also:

WIN_ALARM_DATA

WIN_ALARM_DATA

Gets the number of flashes and number of beeps used as alarm. (Currently always returns the same

value.)

Argument: Xv_opaque

Default: 1 beep, 1 flash

Procs: get

Objects: Xv_Window

See Also:

WIN_ALARM

148 XView Reference Manual

WIN_BACKGROUND_COLOR

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

the window.

Argument: int

Default: 0

Procs: create, get, set

Objects: Xv_Window

See Also: 4.7, 21.3.1.1,

WIN_CMS, WIN_FOREGROUND_COLOR

WIN_BACKGROUND_PIXMAP

Specifies the background pixmap of a window.

Argument: Pixmap

Default:

NULL

Procs: create, get, set

Objects: Xv_Window

WIN_BELOW

Causes the window to be positioned below the sibling window given as the value. Restricted to win-

dows with the same immediate parent (i.e., subwindows). Does not affect the XV_X of the window.

Argument: Xv_Window

Default: N/A

Procs: set, create

Objects: Xv_Window

WIN_BIT_GRAVITY

Sets the Xlib-specific “bit gravity” on the underlying X window associated with the object. See

<X11/X.h> for a list of legal values.

Argument: int

Default: NorthWestGravity

Procs: create, get

Objects: Xv_Window

See Also: 5.3,

CANVAS_FIXED_IMAGE, CANVAS_RESIZE_PROC

WIN_BORDER

Controls whether a window has a border.

Argument: Bool

Default:

TRUE

Procs: create, get, set

Objects: Xv_Window

WIN_CLIENT_DATA

Specifies an arbitrary value to be attached to a window.

Argument: caddr_t

Default: None

Procs: create, get, set

Objects: Xv_Window

See Also: 7.19.1,

XV_KEY_DATA

XView Attributes

XView Attributes 149

WIN_CMD_LINE

Lets an application set the command-line options that can be used to (re)start it. The options passed,

in addition to XView options are stored on a property called WM_COMMAND on the frame window. (The

program xprop can be used to display a window’s properties). Only one base frame window of the

application needs to have this property set. This property is read possibly by a session manager to

restart clients. Setting this attribute to -1 prevents any command-line option information from being

saved on the frame. If there are two or more base frames in the application, the second and subse-

quent base frames should set their

WIN_CMD_LINE attributes to -1 if they want to avoid multiple invo-

cations of the same application by the session manager.

The string passed is copied and cached on the frame.

Warning: Usage of this attribute will make the application non-ICCCM compliant. Use

FRAME_WM_COMMAND_ARGC_ARGV instead. Intermixing the usage of WIN_CMD_LINE and

FRAME_WM_COMMAND_

* attributes has unpredictable results.

Argument: char *

Default: None

Procs: create,get,set

Objects: Xv_Window

See Also:

FRAME_WM_COMMAND_ARGC_ARGV, FRAME_WM_COMMAND_ARGC,

FRAME_WM_COMMAND_ARGV, FRAME_WM_COMMAND_STRINGS, Chapter 12, Interclient

Communication, in Xlib Programming Manual.

WIN_CMS

Window-based objects use colormap segments to get their colors. These objects get a default color-

map segment when they are created, but you can assign a new one using this attribute.

Argument: Cms

Default: Depends on

WIN_INHERIT_COLORS, typically inherits parent’s cms

Procs: create, get, set

Only use create and get for a

FILE_CHOOSER.

Objects: Xv_Window

See Also: 21.5, 21.2.2, 21.1,

WIN_FOREGROUND_COLOR, WIN_BACKGROUND_COLOR

WIN_CMS_DATA

This attribute is obsolete; where possible, the Cms package should be used. It specifies the data for

the colormap segment associated with the window. The data is written into the currently allocated

colormap segment. If a new segment is desired, set it using

WIN_CMS_NAME first.

Argument: Xv_cmsdata *

Default: None

Procs: create, get, set

Objects: Xv_Window

WIN_CMS_NAME

This attribute is obsolete; where possible, the Cms package should be used. Specifies the colormap

segment to be associated with the window.

Argument: char *

Default: None

Procs: create, get, set

Objects: Xv_Window

See Also: 21.2.2

150 XView Reference Manual