Category:Events

Quick Overview

Events are one of the most fundamental things to know about the Nspire Lua language. You can see how events are managed inside the Lua implementation here.

• on.paint(gc) is called when the GUI is painted. 'gc' is the Graphics Context
• on.resize is called when the window is rezised

• on.timer is called at each timer ticks. See timer.

• on.arrowKey is called when an arrow key from the clickPad/TouchPad is pressed (right, left, up, down)
• on.arrowLeft is called when the left arrow is pressed
• on.arrowRight is called when the right arrow is pressed
• on.arrowUp is called when the up arrow is pressed
• on.arrowDown is called when the down arrow is pressed

• on.enterKey is called when the enter key is pressed.
• on.escapeKey is called when the escape key is pressed.
• on.tabKey is called when the tab key is pressed.
• on.deleteKey is called when the delete key is pressed.
• on.backspaceKey is called when the clear key is pressed.
• on.returnKey is called when the return key is pressed.
• on.contextMenu is called when the combo-key Ctrl Menu is pressed.
• on.backtabKey is called when the combo-key Maj Tab is pressed.
• on.clearKey is called when the combo-key Ctrl Clear is pressed.
• on.help is called when the combo-key Ctrl ? is pressed.

• on.charIn is called when the Nspire detects a non arrow key being pressed.

• on.blink called when focus changes, notably when the widget is blinking when selecting an app on the screen (Ctrl-K)
• on.createMathBox called when there is a MathBox created.
• on.create called when the script gets created. Deprecated in 3.2. See on.contruction.
• on.construction called when the script gets created.
• on.deactivate called when the focus is lost on the page (like launching the document, changing page etc...)
• on.activate called when the focus is on the page (like launching the document, changing page etc...)
• on.destroy is called when the document is about to get closed (or cut)

• on.getFocus is called when the script receives user input focus.
• on.loseFocus is called when the script loses user input focus.

• on.mouseDown is called when we press the left mouse button. X and Y are the pressed point coordinates.
• on.mouseUp is called when we release the left mouse button.
• on.mouseMove is called when the mouse moves
• on.grabDown is called when the grabbing motion is detected (When the user presses and holds the Select key on a device, when the user presses Ctrl + Select on a device, or when the user presses the middle mouse button)
• on.grabUp is called after the grabbing action.
• on.grabMove is called when the cusor is moved while grabbed. Doesn't exist anymore in 3.2+.
• on.rightMouseDown is called when the user pushes the "right click" button
• on.rightMouseUp is called when the user releases the "right click" button

• on.keyboardUp() which fires when the tablet's on-screen keyboard gets shown.
• on.keyboardDown() which fires when the tablet's on-screen keyboard gets hidden.

• on.varChange is called when a monitored variable gets changed.
• on.getSymbolList is called when the script app symbol list is being serialized to the clipboard.

• on.save is called when the script app is saved to the document or copied to the clipboard.
• on.restore is called when the script application is restored from its saved state in a document or when the app is pasted into a document..

• on.cutEnabled is called when the "cut" feature gets enabled.
• on.copyEnabled is called when the "copy" feature gets enabled.
• on.pasteEnabled is called when the "pastes" feature gets enabled.
• on.cut is called when the user cuts something.
• on.copy is called when the user copies something.
• on.paste is called when the user pastes something.