SELECT_RANGE

SELECT_RANGE creates a range containing all the text starting at the marker position defined with the SELECT built-in up to but not including the current editing position. The range returned has the same properties as a range returned by CREATE_RANGE. SELECT_RANGE does not stop the highlighting of text. To complete the select process you must set the marker originally returned by SELECT to 0. Note that SELECT_RANGE can cause character padding. The following are the steps needed to complete the selection process.

1. mark$1 := SELECT (NONE)

2. move to a new character position

3. range$1 := SELECT_RANGE

4. mark$1 := 0

Note that SELECT_RANGE uses the same process for creating box range as CREATE_RANGE.

Syntax:

range := SELECT_RANGE

Example:

The following creates a range, R1.

R1 := SELECT_RANGE;

Errors:

TPU$_NOCURRENTBUF Not in a buffer.

TPU$_NOSELECT SELECT must be called before SELECT_RANGE activated.

TPU$_SELRANGEZERO Must specify characters in range.

Related Builtins: