SelectionEvaluateCreateCell[notebook] takes the current selection in a notebook and creates a new cell containing the result obtained by evaluating the contents of the selection using the kernel.
SelectionEvaluateCreateCell[notebook, sel] sets the current selection after the evaluation to be as specified by sel.
The first argument of SelectionEvaluateCreateCell is a NotebookObject.
Possible settings for sel are as in NotebookWrite.
The default for sel is After.
SelectionEvaluateCreateCell[notebook, All] sets the current selection to be the cell corresponding the result from the evaluation.
SelectionEvaluateCreateCell performs the same underlying operation as typing Shift-Enter in the front end. It does not, however, have side effects such as incrementing $Line.
See Section 2.11.3.
See also: SelectionEvaluate, SelectionCreateCell, NotebookRead, NotebookWrite.
New in Version 3.