This is documentation for Mathematica 6, which was
based on an earlier version of the Wolfram Language.
View current documentation (Version 11.2)


gives the current value of item at a location in the Mathematica system and interface.
CurrentValue[{item, spec}]
gives the current value for the feature of item specified by spec.
CurrentValue[obj, item]
gives the current value of item associated with the object obj.
  • CurrentValue by default refers to the location at which it appears in a notebook structure.
  • CurrentValue is most often used inside Dynamic, where it by default refers to the dynamic object being displayed.
  • Values for appropriate items can be reset using CurrentValue[item]=val, or implicitly through Dynamic.
  • For any option in the notebook front end, the current value at a particular location can be accessed using CurrentValue[opt].
  • For options whose settings are lists of the form {"name1"->val1, ...}, CurrentValue[{opt, namei}] picks out the current value of vali.
  • CurrentValue[{StyleDefinitions, "style"}] gives the explicit style definitions that would be used for the style with name style at the current location.
  • Possible special items that can be used in CurrentValue include:
"MouseOver"True if the mouse is over the location
"SelectionData"the contents of the selection in this notebook
"SelectionOver"True if the selection includes the current location
  • The following refer to the mouse:
"MouseButtons"a list of mouse buttons currently pressed
"MouseButtonTest"True if the main mouse button is currently pressed
{"MouseButtonTest",i}True if mouse button i is currently pressed
"MouseClickCount"number of mouse clicks for the triggering event
"MouseOver"True if the mouse is over the current location
"MousePosition"the current position of the mouse
{"MousePosition",coords}the mouse position in the specified coordinate system
  • The primary mouse button is represented as 1. The secondary ("right") button is 2. The scroll wheel button is typically 3. Additional buttons are given higher numbers.
  • The following refer to modifier keys:
"ModifierKeys"a list of all modifier keys currently being pressed
"AltKey"True if the Alt or Cmd key is currently pressed
"CommandKey"True if the Alt or Cmd key is currently pressed
"ControlKey"True if the Ctrl key is currently pressed
"OptionKey"True if the Option key on a Macintosh is currently pressed
"ShiftKey"True if the Shift key is currently pressed
  • The following refer to controller devices such as gamepads:
"ControllerData"low-level data on states of all controllers
{"ControllerData",ids}data on controllers with the specified identifiers
  • The following refer to the event or action currently being handled:
"EventKey"key that was pressed
"EventAbsoluteTime"absolute time when the event occurred
"EventData"data about the event
  • The following refer to the evaluation currently being performed:
"DynamicEvaluation"True if the evaluation is associated with Dynamic
"SynchronousEvaluation"True if the evaluation is being performed synchronously
  • The following special items refer to the complete current notebook:
"NotebookDirectory"directory name
"NotebookFileName"name of file, without path
"NotebookFullFileName"full file name, including path
"NotebookSelected"True if the notebook is selected
  • The following refer to the font being used; all are given in printer's points:
"FontAscenderHeight"height of ascenders for lowercase letters
"FontAxisOffset"offset of the font axis above the baseline
"FontCapHeight"height of capital letters
"FontDescenderDepth"depth of descenders for lowercase letters
"FontLineHeight"total height of lines of text
"FontMWidth"width of an "m"
"FontNWidth"width of an "n"
"FontThickness"default stroke thickness
"FontXHeight"height of an "x"
  • The following refer to system font settings:
"ControlsFontFamily"font family for system controls
"ControlsFontSize"default font size for system controls
"PanelFontFamily"font family for system panels
"PanelFontSize"default font size for system panels
$FrontEndthe whole front end session
InputNotebook[]the currently selected notebook
EvaluationNotebook[]the notebook in which the current evaluation is occurring
NotebookSelection[nb]the current selection within a notebook
New in 6