CurrentValue |  |
CurrentValue[item]
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 |
Get the current mouse position:
| Out[1]= |  |
Dynamically update the current value:
| Out[1]= |  |
| |
|
|
|
|
 |
|
|
EXAMPLES
Basic Examples 
Properties & Relations 