TPUHELP.HLB  —  MOVE_TEXT
  MOVE_TEXT

     Moves the text you specify, putting it before the current position in
     the current buffer.  The text is entered according to the current mode
     of the buffer (INSERT or OVERSTRIKE).

  Syntax

     [range1 := ] MOVE_TEXT ({ string | range2 | buffer})

  Parameters

     range1     A range where the copied text has been placed.

     string     A string that you want to copy.

     range2     A range that contains the text you want to move.  The text
                is removed from its original location.

     buffer     A buffer that contains the text you want to move.  The text
                is removed from its original location.

  Comments

     If the current buffer is in insert mode, the text is inserted before
     the current position in the buffer.  If the current buffer is in
     overstrike mode, the moved text replaces existing text starting at the
     current position and continuing for the length of the string, range, or
     buffer.

     You can not add a buffer or range to itself.

     If the current buffer is mapped to a visible window, MOVE_TEXT causes
     TPU to synchronize the active editing point with the active cursor
     position.  As a result, TPU may insert padding blanks if the cursor
     position is not on a character or blank space.

  Examples

     1.  MOVE_TEXT ("The readiness is all");

         Copies the string, putting it before the current position.

     2.  MOVE_TEXT (main_buffer);

         Removes text from the main buffer and puts it before the current
         position in the current buffer.

  Related topics

     COPY_TEXT   SET(INSERT)   SET(OVERSTRIKE)
Close Help