You are here: Lua Scripting Resources eGuide > Lua Scripting API Reference Guide > Event Handling > restore

8.37 restore

on.restore(state)

This routine is called when the script application is restored from its saved state in a document or when the app is pasted into a document. It is called only if the state was saved with the application when it was previously copied to the Clipboard or saved in a document. See the on.save handler.
The parameter state is the table that the on.save event handler returned.

Warning

Functionality that is not available during initialization is also not usable within on.restore. Among the functions that cannot be called are math.eval and platform.isDeviceModeRendering.

Introduced in platform.apiLevel = '1.0'