WINSAVE Mnemonic - Save a copy of a character window (Terminal Device)
Syntax
'WINSAVE'(windowID, keystr)
Description
|
Parameter |
Description |
|
windowID |
The ID number of the character window that should be saved. |
|
keystr |
A text string to be associated with the saved character window. |
In BBj 15.0 and higher, the 'WINSAVE' mnemonic makes a copy of the currently active character window that has the supplied ID number and stores it in a map of inactive "saved" character windows.
The text key string parameter is any arbitrary but unique name which serves as a key for identifying the saved character in the map. It does not correspond to the title of the character window (if the window has a title) or have any other purpose besides uniquely identifying the saved character window in the storage map.
A saved character window is inactive; it cannot be displayed or updated with new text or accept input. It will not respond to any other terminal device mnemonics. It is not kept in sync with the original character window it was copied from, meaning that further updates to the original window (which remains active) will not be applied to the saved copy of the window.
Saved character windows can be retrieved with the 'WINRESTORE' mnemonic or discarded with the 'WINDELETE' mnemonic. Saving a character window does not affect the original character window, and does not trigger a refresh of the screen.