Product Documentation
Virtuoso Studio Design Environment SKILL Reference
Product Version IC23.1, November 2023

geSwitchInContext

geSwitchInContext( 
w_windowId 
t_accessMode 
d_instId 
x_iteration 
x_row 
x_col 
[ verbose ]
)
=> w_windowId / nil 

Description

Switches into an instance by using the view name specified in the hierarchy manager configuration context. If the correct configuration context is not found, this function uses the geSwitch command to perform the switch.

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) and 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>

x_row

Row of the arrayed instance.

x_col

Column of the arrayed instance.

verbose

This optional argument diplays a warning message when something is incorrect.

Value Returned

w_windowId

The database ID of the window that is switched into.

nil

The instance in not switched into.

Examples

Switches into the instance, instId, by using the view name specified in the hierarchy manager configuration context.

geSwitchInContext(hiGetCurrentWindow() "r" instId 0 0 0)

Related Topics

Procedural-Level Functions


Return to top
 ⠀
X