Built-in Mathematica Symbol

NotebookEventActions

NotebookEventActions
is a notebook option that gives a list of actions to perform when specified events occur in connection with the notebook.

NotebookEventActions->{"event₁":>action₁, "event₂":>action₂, ...} specifies that action_i should be evaluated whenever "event_i" occurs in connection with the notebook.

The possible event specifications are the same as for EventHandler, with the following addition:

"WindowClose"

window being closed

Settings for NotebookEventActions are often defined at the level of stylesheets, rather than for individual notebooks.

By default, any action specified for an event by NotebookEventActions will override any default action that Mathematica would take for that event.

The default behavior can be changed by including rules for PassEventsDown or PassEventsUp in the list given as the setting for NotebookEventActions.

Set up a certain action to take place when a notebook is closed:

With the notebook open, k is unchanged:

When you close the notebook window, k is incremented:

Set up a certain action to take place when a notebook is closed:

With the notebook open, k is unchanged:

When you close the notebook window, k is incremented:

Create a notebook window:

Set NotebookEventActions so that the notebook will change color when clicked:

Clicking the notebook changes its background:

Make an action occur when the Enter key is pressed:

Define actions for "MouseDown" and "MouseUp":

The background will be pink only while the mouse button is held down:

After the mouse is released, the notebook is back to its normal background:

This NotebookEventActions setting blocks the normal Enter key behavior:

Pressing Enter changes the background but does not start a new line:

This inserts a newline as part of the action specified for "ReturnKeyDown":

Pressing Enter in this notebook inserts a newline as well as setting the background:

Specify a NotebookEventActions setting that goes away after being activated once:

A single Enter changes the background without entering a newline:

Also, NotebookEventActions has been reset to None:

Now, more Enter keystrokes add new lines as usual: