READ_GLOBAL_SELECT
Gets information from or about a global selection. Copies the information
into DECTPU'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 DECTPU buffer.
Comments
All text read from the primary global selection is copied into the
current buffer starting at the editing point. If DECTPU 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");