SELECT_RANGE

    Returns a range containing all the characters between the marker
    established with the SELECT built-in and the current character
    position.  SELECT_RANGE does not include the character at the position
    ending the range.

 Syntax

    range := SELECT_RANGE

 Comments

    To select text, do the following steps:

    1.  Use the SELECT built-in to put a marker where you want to begin the
        selection -- for example:

           begin_select := SELECT (BOLD));

    2.  Move the cursor to select the text.

    3.  When all of the text is selected, create a range containing the
        selected text -- for example:

           selrange := SELECT_RANGE;

    4.  To end the selection, set the marker for the beginning of the range
        to null -- for example:

           begin_select := 0;

 Examples

    1.  select_1 := SELECT_RANGE;

        Stores in the variable SELECT_1 the range for the currently
        selected characters.

    2.  The following procedure shows how to create two select ranges:

        PROCEDURE user_select
           begin_select := SELECT (REVERSE);
           MESSAGE ("Selection started.");
           MOVE_VERTICAL (+5);
           selrange1 := SELECT_RANGE;
           MOVE_VERTICAL (+5);
           selrange2 := SELECT_RANGE;
           !    Stop the selection by setting the marker to null
           begin_select := 0;
        ENDPROCEDURE;

 Related topics

    MARK   SELECT