*RESTSCR (KEYIN and DISPLAY)

*RESTSCR[={n}])

This list control restores the top or the designated, {n}th, *SAVESW image from the program's stack. It then resets the current subwindow to the coordinates that were in effect at the time the image was saved.

{n} must be a decimal constant separated from *RESTSCR by an equal sign. If a specific image is not designated, the last image saved is restored unless all images have been removed from the stack. The following code shows the proper relationship between *RESTSCR and *SAVESW when a new subwindow is being defined:

	DISPLAY	SAVESW,SETSWALL=10:15:20:55:
		BORDER,ES,*SHRINKSW:
	...
	DISPLAY	*RESTSCR

This type of sequence should only be used if the new subwindow is contained in the old window. Otherwise, portions of the screen that are modified are not saved. This sequence should also be used if no new subwindow is being defined.