Library /sys$common/syshlp/EVE$HELP.HLB  —  RESTORE_BOX_SELECTION
  RESTORE BOX SELECTION

  Restores (undeletes) the box you last erased with pending delete or with
  DECwindows Quick Copy. (Quick Copy uses ALT/M2CLICK or ALT/SHIFT/M2DRAG---
  see help on Quick Copy.)

  Steps:

     1.  Put the cursor where you want to restore the text---that is,
         where you want the upper left corner of the box.

     2.  Use the RESTORE BOX SELECTION command---or if SET BOX SELECT is in
         effect, you can use RESTORE SELECTION.

  Example:

     In the following example, you enable pending delete, select a box
     (instead of a linear range), erase the selection, and then put back the
     erased text:

        Command: SET PENDING DELETE
        Command: BOX SELECT
                    .
                    .
        Command: DELETE
        Command: RESTORE BOX SELECTION

  Usage notes:

  o  RESTORE BOX SELECTION overwrites existing text---unless SET BOX NOPAD
     is in effect and you are restoring in an insert-mode buffer:

     Setting          Effects on RESTORE BOX SELECTION
     -------------------------------------------------------------------
     SET BOX NOPAD    Restoring a box depends on the mode of the buffer.
                      In insert mode, the box pushes existing text to
                      the right. In overstrike mode, the box overwrites
                      existing text.

     SET BOX PAD      Restoring a box overwrites existing text regardless
     (default)        of the mode of the buffer.

  o  Restoring a box converts tab characters to spaces, to the right of the
     box or overlapping the box. See help on CONVERT TABS.

  o  If you erased a standard, linear selection and then use RESTORE BOX
     SELECTION, the restored text may have a ragged right edge because the
     erasing did not pad the text with spaces.

  o  Pending delete uses the $RESTORE$SELECTION$ buffer. Thus, you can use
     pending delete and RESTORE BOX SELECTION for cutting and pasting text
     without affecting the contents of the INSERT HERE buffer or the
     clipboard.

  +----------------------------------------------------------------+
  | Box-editing operations are slow with very long box selections, |
  | particularly if buffer-change journaling is in effect (which   |
  | is the default).                                               |
  +----------------------------------------------------------------+

  Related topics:

     Pending Delete    RESTORE SELECTION    SET BOX PAD    SET BOX NOPAD
Close Help