PreviousCell

PreviousCell[]

returns the CellObject corresponding to the cell directly above the currently evaluating cell.

PreviousCell[cellobj]

starts looking from the given cell.

PreviousCell[NotebookSelection[nbobj]]

starts looking from the topmost selected item.

Details and Options

  • The evaluation of PreviousCell will not result in the selection or insertion point's changing position.
  • If the requested cell is not available or the top of the notebook is reached, PreviousCell will return None.
  • PreviousCell can return the first cell before the reference point that matches given criteria by specifying one or more of the following options:
  • CellIDcell IDs to match
    CellLabelIn/Out label strings to match
    CellStylenamed cell styles to match
    CellTagscell tags to match
    Evaluatorcells that match the specified evaluator
    GeneratedCellmatch only generated output cells if True, or only non-generated cells if False
  • PreviousCell[cellobj] of an inline cell will return the previous inline cell in the same cell. PreviousCell[NotebookSelection[nbobj]] will always return the previous regular cell, regardless of whether an inline cell is presently selected.

Examples

Basic Examples  (3)

Get the CellObject for the previous cell:

Read this caption cell into the kernel:

There are no "Section" style cells above this point in this notebook:

Wolfram Research (2014), PreviousCell, Wolfram Language function, https://reference.wolfram.com/language/ref/PreviousCell.html (updated 2020).

Text

Wolfram Research (2014), PreviousCell, Wolfram Language function, https://reference.wolfram.com/language/ref/PreviousCell.html (updated 2020).

CMS

Wolfram Language. 2014. "PreviousCell." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2020. https://reference.wolfram.com/language/ref/PreviousCell.html.

APA

Wolfram Language. (2014). PreviousCell. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/PreviousCell.html

BibTeX

@misc{reference.wolfram_2021_previouscell, author="Wolfram Research", title="{PreviousCell}", year="2020", howpublished="\url{https://reference.wolfram.com/language/ref/PreviousCell.html}", note=[Accessed: 07-December-2021 ]}

BibLaTeX

@online{reference.wolfram_2021_previouscell, organization={Wolfram Research}, title={PreviousCell}, year={2020}, url={https://reference.wolfram.com/language/ref/PreviousCell.html}, note=[Accessed: 07-December-2021 ]}