deSwap

deSwap( 
[ l_fileSpec [ g_winSpec [ t_accessMode [ t_appName] ] ] ] 
) 
=> w_window / nil

Description

This function is same as deOpen, except that if the window already exists, the current contents are not removed. Instead the current stack item is replaced with the new design.

This corresponds to a trigger argument action of ’swap only if the view types of the old and new contents are the same. Otherwise, the old contents are explicitly closed and the new contents explicitly opened and installed. If the current contents are being edited in place, the new contents are installed in edit-in-place. If the new contents being swapped consist of a hierarchy, the entire hierarchy is installed in edit-in-place. In this latter case, the ’swap action will not be passed even when the viewTypes are the same.

Arguments

l_fileSpec	File specification for the cellview to be swapped into the given window. See deOpen for a detailed explanation of the format for this argument.
g_winSpec	Window specification for the window in which to do the swap. See deOpen for a detailed description of this argument.
t_accessMode	Access mode desired for the new design.
	Valid values: edit, read, overwrite, a, r, or w.
t_appName	Name of the application to install after the data is placed on the stack. The application must be a part of the view type subclass tree that is indicated by the data.

Value Returned

w_window

Window in which the swap is done. Normally this is the same as the window passed in, but if necessary a new window is created and returned.

Examples

Brings up the Open File form, asking for the library, cell, and view names of a cellview to edit. When this form is completed, the cellview opened replaces the top of the stack in window(3).

deSwap( nil window(3) )

Swaps the top of the stack in window(3) with the cellview test ff graphic opening that in read mode, then pushes into instance I4 in edit mode.

deSwap( myFileSpec window(3) )

Return to top