Volume 7B: XView Reference Manual

TEXTSW_ACTION_*

Appendix C, Textsw Action Attributes, describes the textsw action attributes. These attributes are

only valid for use with a textsw notify procedure.

TEXTSW_AGAIN_RECORDING

If FALSE, changes to the textsw are not repeated when the user invokes AGAIN. Disabling reduces

memory overhead.

Argument: Bool

Default:

TRUE

Procs: create, get, set

Objects: Textsw

TEXTSW_AUTO_INDENT

If TRUE, automatically indents a new line to match the previous line.

Argument: Bool

Default:

FALSE

Procs: create, get, set

Objects: Textsw

TEXTSW_AUTO_SCROLL_BY

Specifies the number of lines to scroll when type-in moves insert point below the view.

Argument: int

Default: 1

Procs: create, get, set

Objects: Textsw

TEXTSW_BLINK_CARET

Determines whether the caret blinks ( for better performance don’t blink).

Argument: Bool

Default:

FALSE

Procs: create, get, set

Objects: Textsw

TEXTSW_BROWSING

If

TRUE, prevents editing of displayed text. If another file is loaded in, browsing stays on.

Argument: Bool

Default:

FALSE

Procs: create, get, set

Objects: Textsw

TEXTSW_CHECKPOINT_FREQUENCY

Specifies the number of edits between checkpoints. Set to 0 to disable checkpointing.

Argument: int

Default: 0

Procs: create, get, set

Objects: Textsw

XView Attributes

XView Attributes 141

TEXTSW_CLIENT_DATA

Specifies the pointer to arbitrary client data.

Argument: Xv_opaque

Default:

NULL

Procs: create, get, set

Objects: Textsw

TEXTSW_CONFIRM_OVERWRITE

Specifies confirmation of any request to write to an existing file.

Argument: Bool

Default:

TRUE

Procs: create, get, set

Objects: Textsw

TEXTSW_CONTENTS

Specifies the text for a subwindow. xv_get needs additional parameters (see Chapter 8, Text

Subwindows, in XView Programming Manual).

Argument: char *

Default:

NULL

Procs: create, get, set

Objects: Textsw

See Also: 8.6.2

TEXTSW_CONTROL_CHARS_USE_FONT

If FALSE, control characters always display as an up arrow followed by a character instead of what-

ever glyph is in the current font.

Argument: Bool

Default:

FALSE

Procs: create, get, set

Objects: Textsw

TEXTSW_DESTROY_VIEW

The current view will be destroyed.

Argument: No value

TEXTSW_DISABLE_CD

Stops textsw from changing current working directory and grays out associated items in the menu.

Argument: Bool

Default:

FALSE

Procs: create, get, set

Objects: Textsw

TEXTSW_DISABLE_LOAD

Prevents files from being loaded into the textsw and grays out the associated items in the menu.

Argument: Bool

Default:

FALSE

Procs: create, get, set

Objects: Textsw

142 XView Reference Manual

TEXTSW_EDIT_COUNT

Monotonically increments count of the number of edits made to the textsw.

Argument: int

Procs: get

Objects: Textsw

TEXTSW_EXTRAS_CMD_MENU

Returns the Extras submenu of the TEXT PANE menu for the textsw.

Return Type: Menu

Procs: get

Objects: Textsw

TEXTSW_FILE

For xv_create and xv_set, specifies the name of the file to load; for xv_get, returns the name of

the file loaded or

NULL if no file was loaded.

Argument: char *

Default:

NULL

Procs: create, get, set

Objects: Textsw

See Also: 8.4.1

TEXTSW_FILE_CONTENTS

Initializes the text subwindow contents from a file, yet still edits the contents in memory as if specified

using

TEXTSW_FILE.

Argument: char *

Default:

NULL

Procs: create, set

Objects: Textsw

See Also: 8.6.1

TEXTSW_FIRST

Specifies the zero-based index of first displayed character.

Argument: int

Procs: create, get, set

Objects: Textsw

See Also: 8.4.1

TEXTSW_FIRST_LINE

Specifies the zero-based index of first displayed line.

Return Type: int

Procs: get

Objects: Textsw

See Also: 8.7.2

TEXTSW_FONT

Specifies the font to use in a text subwindow.

Argument: Xv_Font

Procs: create, get, set

Objects: Textsw

See Also: 8.1

XView Attributes

XView Attributes 143

TEXTSW_HISTORY_LIMIT

Specifies the number of user action sequences that can be undone.

Argument: int

Default: 50

Procs: create, get, set

Objects: Textsw

TEXTSW_IGNORE_LIMIT

Specifies the number of edits textsw allows before vetoing destroy. Valid values are 0, which

means the destroy will be vetoed if there have been any edits, and

TEXTSW_ INFINITY, which

means the destroy will never be vetoed. Vetoing a destroy means a confirm notice is displayed

when the textsw is about to be destroyed. This veto confirm message is displayed only if the ignore

limit is set to 0. A textsw is destroyed when the textsw or its enclosing frame is the object of an

xv_destroy() call, which occurs when the application is quit from the Window Manager menu.

Argument: int

Default: 0

Procs: create, get, set

Objects: Textsw

TEXTSW_INSERT_FROM_FILE

Inserts the contents of a file into a text subwindow at the current insertion point.

Argument: char *

Default: None

Procs: set, create

Objects: Textsw

See Also: 8.6.3

TEXTSW_INSERT_MAKES_VISIBLE

Controls whether insertion causes repositioning to make inserted text visible. Possible values are

TEXTSW_ALWAYS or TEXTSW_ IF_AUTO_SCROLL.

Argument: Textsw_enum

Default:

TEXTSW_ALWAYS

Procs: create, get, set

Objects: Textsw

See Also: 8.7.4.2

TEXTSW_INSERTION_POINT

Specifies the index of the current insertion point.

Argument: Textsw_index

Default: None

Procs: create, get, set

Objects: Textsw

See Also: 8.4.3.1

TEXTSW_LENGTH

Specifies the length of the textsw’s contents.

Argument: int

Procs: get

Objects: Textsw

See Also: 8.3

144 XView Reference Manual

TEXTSW_LINE_BREAK_ACTION

Determines how the textsw treats file lines that are too big to fit on one display line. TEXTSW_CLIP

clips the line when it gets too long to fit; you don’t see any additional characters typed on the line

when the line exceeds the width of the textsw. TEXTSW_WRAP_CHAR wraps the line around so the part

of the line that exceeds the width of the textsw is displayed on the next line(s). Textsw does not insert

a CR. It just displays it as if a CR were there. If this happens in the middle of the word, the textsw

will display the line as if a CR were inserted in the middle of the word. TEXTSW_WRAP_WORD wraps at

the word level, thus, it will not break a word up to wrap around. It will figure out where the word

starts and display as if a CR were inserted before the word.

Argument: Textsw_enum

Valid Values: {

TEXTSW_CLIP, TEXTSW_WRAP_AT_CHAR, TEXTSW_WRAP_AT_WORD}

Default: TEXTSW_WRAP_AT_WORD

Procs: create, get, set

Objects: Textsw

See Also: 8.7.1

TEXTSW_LOWER_CONTEXT

Specifies the minimum number of lines to maintain between insertion point and bottom of view. A

value of –1 turns auto scrolling off.

Argument: int

Default: 0

Procs: create, get, set

Objects: Textsw

TEXTSW_MEMORY_MAXIMUM

Specifies how much memory to use when not editing files (e.g., editing in memory). This attribute

only takes effect at create time or after the window is reset with textsw_reset. The lower bound

is 1K bytes, which is silently enforced.

Argument: int

Default: 20000

Procs: create, get, set

Objects: Textsw

See Also: 8.4.8

TEXTSW_MODIFIED

Specifies whether the textsw has been modified.

Argument: Bool

Procs: get

Objects: Textsw

See Also: 8.4.1

TEXTSW_MULTI_CLICK_SPACE

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

considered a multi-click.

Argument: int

Default: 4

Procs: create, get, set

Objects: Textsw

XView Attributes

XView Attributes 145