STATESAVE

8.0.4, ANSI

The STATESAVE instruction saves the screen state information. The instruction uses the following format:

Where:

label

Optional. A Program Execution Label.

state

Required. A previously defined Character String Variable that save the screen state information.

Flags Affected: EOS

Note the following:

1. The information is saved starting at the first position of {state}. The Form Pointer is set to one (1) and the Length Pointer is set to the last character moved.

2. The size required for the {state} variable may be determined by using the STATESIZE instruction.

3. If {state} is not large enough to hold the entire contents, the EOS flag is set. No data is moved to {state} when the EOS flag is set.

4. The information saved includes the current subwindow parameters, the cursor position, the echo secret character, the color and display attributes and the KEYIN case conversion mode.

5. The current cursor position is not affected.

See Also: STATERESTORE, STATESIZE, Interactive I/O Instructions