.select( "multiple", value )
Changes the selection state of rows in a set. Contrast with the Rows.select( "multiple" ) function, which changes the selection state of the current row.
Returns the 'this' object.
The required literal string "multiple" distinguishes this function from the Rows.select(options) function.
The optional value can be a boolean or a string. Boolean values of value have the following meaning:
If value is a string value, the following values are allowed:
NOTE: Before the .select operation is performed, the 'rowpreselect' event is triggered. if the event handler sets the 'success' member of the result object parameter to false, then the action is aborted and the current row will not change. Otherwise, the action is performed and following it, the 'rowpostselect' event is triggered as a final step.