geSwitch

geSwitch( 
w_windowId 
t_accessMode 
d_instId 
x_iteration 
x_row 
x_col 
)
=> w_windowId / nil 

Description

Switches into an instance.

w_windowId->viewNameList is used as a switch for the instance. w_windowId must be a valid Graphics Editor window with at least one stack element, and d_instId must be an instance in the edit cellview in w_windowId.

• If d_instId is an iterated instance, x_iteration is the particular iteration that is switched to.
• If d_instId is an arrayed instance, x_row and x_col indicate the particular element that is switched to.

Arguments

w_windowId	Database ID of the window in which to do the switch.
t_accessMode	Access mode used to open the instance master. Valid Values: r (read) or a (append)
d_instId	Database ID of the instance to switch into.
x_iteration	Offset in the array of the instance (not the bit number). For example: iteration 1 of I1<0:5> descends into I1<1> iteration 2 of I1<1:6> descends into I1<3> iteration 3 of I1<2:7> descends into I1<5> iteration 4 of I1<3:8> descends into I1<7> iteration 4 of I1<5:0> descends into I1<4> Default: 0
x_row	Row of the arrayed instance.
x_col	Column of the arrayed instance.

Value Returned

w_windowId	The database ID of the window that is switched into.
nil	The instance in not switched into.

Examples

Opens the master of inst5 in win3 in edit mode and switches it to iteration 2 of the instance in row 3, column 3.

geSwitch( win3 "a" inst5 2 3 3 )

Related Topics

Procedural-Level Functions

Return to top