selectionToString() is used to pass the values of the selected rows into a tab-separated list. In a single-row selection mode, the method returns the row which is currently selected:
LET tostr = DIALOG.SelectionToString("scrarr")
There is some specifics about using variables with ui.Dialog methods.
You can learn about them here.
The method needs one argument which specifies the name of the screen array from which the selected rows will be taken.
The method retrieves the values according to these rules:
The order of the rows is defined by the user-specified settings. If the user did not specify any settings, the default order is used.
If a column was moved, its values will be placed to the same position as in the table.
If a column is hidden, its values will be ignored.
Phantom columns are ignored.
If the passed value contains special characters (double-quotes, controls characters having ASCII less then 0x20, new-line characters), it will be taken into double quotes.