geGetHierMemInst

geGetHierMemInst( 
[ w_windowId ] 
)
=> l_list / nil 

Description

Returns a list describing the hierarchy of instances that have been descended into or edited-in-place to arrive at the cellview in the window.

The list is in the form:

dbInst1  3
dbInst2  4

Each element in the list represents the database ID of the instance and iteration number of the instance that was descended into or edited-in-place at a higher level of the window. If the cellview currently occupying the window is the top-level cellview—that is, no descends or edits-in-place have been done to arrive at it—then the list returned by geGetHierMemInst is nil.

Arguments

w_windowId

Database ID of the window from which the hierarchy information is wanted.

Value Returned

l_list	Instance hierarchy description for this window displayed in a list. The first element in the list is the instance ID. The second element in the list is the iteration number of the instance. For example, if you descend into iteration number 4, it always means I1<4> regardless of the order of the iterated instance.
nil	The current window is empty or if the current window is undefined.

Examples

geGetHierMemInst( getCurrentWindow( ) )

The example returns the following:

db:01234567  0
db:45678900  1

Related Topics

Edit and Display Functions

geGetHierMemInst

Return to top