gePush

gePush( 
w_windowId 
t_accessMode 
d_instId 
x_iteration
x_row 
x_col 
[ g_cancel ]
)
=> t / nil 

Description

Pushes into an 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 pushed.
• If d_instId is an arrayed instance, x_row and x_col indicate the particular element that is pushed.

Arguments

w_windowId	Database ID of the window in which to do the push.
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 push into.
x_iteration	Desired iteration of the given instance. Default: 0
x_row	Row of the arrayed instance.
x_col	Column of the arrayed instance.
g_cancel	This optional argument is currently ignored, and will be removed in a future release.

Value Returned

t	The instance is pushed into.
nil	The instance is not pushed into.

Examples

Opens the master of inst5 in win3 in edit mode before pushing it on the stack. Opens iteration 1 of the instance in row 3, column 3.

gePush( win3 "a" inst5 1 3 3 )

Related Topics

Procedural-Level Functions

Return to top