/sys$common/syshlp/TPUHELP.HLB  —  READ_CLIPBOARD
  READ_CLIPBOARD

  Reads string-formatted data from the clipboard.  Copies the data into the
  current TPU buffer at the editing point, using the buffer's current
  text mode (INSERT or OVERSTRIKE).

  Syntax

     [range | unspecified] := READ_CLIPBOARD

  Parameters

     range                A range containing the text copied into the
                          current buffer.

     UNSPECIFIED          A data type indicating that no data was obtained
                          from the clipboard.

  Comments

     If TPU finds a line-feed character in the data, it removes the line
     feed and any adjacent carriage returns and puts the data after the line
     feed on the next line of the buffer.  If TPU must truncate the data
     from the clipboard, TPU copies the truncated text into the current
     buffer.

     All text read from the clipboard is copied into the buffer starting at
     the editing point.  If TPU must start a new line to fit all the text
     into the buffer, the new line starts at column 1, even if the current
     left margin is not set at column 1.

  Example

     The following statement copies the contents of the clipboard into the
     current buffer:

     READ_CLIPBOARD;
Close Help