VAXTPU READ_GLOBAL_SELECT — VMS 5.2

 READ_GLOBAL_SELECT

 Gets information from or about a global selection.  Copies the information
 into VAXTPU'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 VAXTPU buffer.

 Comments

    All text read from the primary global selection is copied into the
    current buffer starting at the editing point.  If VAXTPU 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");
Museum

VAXTPU READ_GLOBAL_SELECT — VMS 5.2
