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");