WINSAVE

8.0.4, ANSI

The WINSAVE instruction saves the character and attribute contents of a screen window. The instruction uses the following format:

Where:

label

Optional. A Program Execution Label.

window

Required. A previously defined Character String Variable into which the screen window information is placed.

Flags Affected: EOS

Note the following:

1. The characters and attributes are saved starting at the first position of {window}. 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 {window} variable may be determined by using the WINSIZE instruction.

3. If {window} is not large enough to hold the entire subwindow contents, the EOS flag is set.

4. The information is saved in row major order.

5. The current cursor position is not affected.

6. Use of this instruction on Linux systems requires subwindow emulation in the screen definition file.

See Also: WINRESTORE, WINSIZE, Interactive I/O Instructions