Library /sys$common/syshlp/TPUHELP.HLB  —  SELECT_RANGE
  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
Close Help