RESTORESCREEN
Syntax
Command
Mandatory parameter Optional parameter Mandatory keyword Optional keyword |
RESTORESCREEN ([<Form container item> | <Insertable form>, <Custom key>])
Description
Restores a screen, screen item or insertable form previously retained with the RETAINSCREEN command.
Diagram
Returned value type
None
Parameters
| Parameter | Description |
| <Form container item> |
A panel, groupbox or scrollbox to restore. When omitted the complete form will be restored. |
| <Insertable form> |
An insertable form to restore. |
| <Custem key> |
A custom key to identify the specific version of the insertable form retained. The key must match the key used in the RETAINSCREEN instruction. The maximum length of the key is 50 characters. |
Remarks
When a new user signs in all saved information is removed
When with a RESTORESCREEN() the retained information doesn't exist, the form is initialized.
When with a RESTORESCREEN() the incorrect version of a form is available, the form is initialized.
Per screen only one record is kept in the database, except with an insertable form where the custom key is used to distinguish between the different versions.
The information is shared between subsessions.
Retained form data for a normal form can only be read back in the same form. Retained data from an insertable form can be read back in any form using that insertable form using the custom key to restore the correct version.
Examples
restorescreen (panel1)
restorescreen (insertable1, 'key1')
Relevant page