SelectionMove

SelectionMove[obj, dir, unit]
moves the current selection in an open notebook in the front end in the direction dir by the specified unit.

SelectionMove[obj, dir, unit, n]
repeats the move n times.

Details and OptionsDetails and Options

  • The first argument of SelectionMove can be a NotebookObject or a CellObject.
  • Possible direction specifications are:
  • Nextmake the selection be the next unit of the specified type
    Previousmake the selection be the previous unit of the specified type
    Aftermake the selection be just after the end of the present unit
    Beforemake the selection be just before the beginning of the present unit
    Allmake the selection be the whole of the present unit
  • Possible unit specifications are:
  • Characterindividual character
    Wordword or other token
    Expressioncomplete subexpression
    TextLineline of text
    GraphicsContentsthe contents of a graphics object
    Graphicscomplete graphics object
    CellContentsthe contents of a cell
    Cellcomplete cell
    CellGroupcell group
    GeneratedCellcell generated by the current evaluation
    Notebookcomplete notebook
  • Unless the option setting AutoScroll->False is given, the front end will scroll a notebook so that the result of SelectionMove is visible. »
  • The front end will also usually highlight the region corresponding to the result.
  • With direction specifications and , SelectionMove will usually make the current selection be an insertion point between two units of the specified type. »
  • SelectionMove returns $Failed if it cannot move the selection in the way you request.
  • A GeneratedCell corresponds to an element of the output.

ExamplesExamplesopen allclose all

Basic Examples (3)Basic Examples (3)

Select the first cell after the initial selection position:

Select the third cell after the initial selection position:

Move selection to a cell:

In[1]:=
Click for copyable input
New in 3 | Last modified in 9
New to Mathematica? Find your learning path »
Have a question? Ask support »