TPUHELP.HLB  —  READ_GLOBAL_SELECT
  READ_GLOBAL_SELECT

  Gets information from or about a global selection.  Copies the information
  into TPU'S current buffer at the editing point using the buffer's
  current text mode (INSERT or OVERSTRIKE).  Also puts line breaks in the
  text copied into the buffer.

  Syntax

     [range | UNSPECIFIED := ] READ_GLOBAL_SELECT ({PRIMARY | SECONDARY
                                                    | selection_name_string},
                                                    string)

  Parameters

     range                   A range containing the string copied to the
                             buffer.

     UNSPECIFIED             A data type indicating that the information
                             requested by the layered application was not
                             available.

     PRIMARY                 A keyword indicating that the layered
                             application is requesting information about or
                             from the PRIMARY global selection.

     SECONDARY               A keyword indicating that the layered
                             application is requesting information about or
                             from the SECONDARY global selection.

     selection_name_string   A string identifying the global selection that
                             is the subject of the layered application's
                             information request.  You specify the selection
                             name as a string if the layered application
                             needs information about a selection other than
                             the PRIMARY or SECONDARY global selection.

     string                  The string-formatted information returned from
                             the global selection.  If the information
                             requested was in integer format in the
                             DECwindows environment, READ_GLOBAL_SELECT
                             converts the information to string format
                             before copying it to the TPU buffer.

  Comments

     All text read from the primary global selection is copied into the
     current 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.

     If the global selection information requested is an integer, the
     built-in converts the integer into a string before copying it into the
     current buffer.  If the information requested is a string, the built-in
     copies the string into the buffer, replacing any line feeds with line
     breaks.

  Example

     The following statement reads the string-formatted contents of the
     primary global selection and copies it into the current buffer at the
     current location.

     READ_GLOBAL_SELECTION (PRIMARY, "STRING");
Close Help