geGetInstHierPath

geGetInstHierPath( 
w_windowId 
)
=> l_instance-hierarchy / nil 

Description

Similar to geGetInstHier but returns additional information for mosaic instances. This function returns a list of list describing the hierarchy of instances that have been descended into or edited-in-place in the current window to arrive at the cellview in the window. The list contains the following information for each instance: (dbinst memInst row column)

Where, dbinst is the database name of the instance, memInst is the iteration number, row is the row position, and column is the column position of the instance.

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 string returned by geGetInstHier is ().

Arguments

w_windowId

Database ID of the window for which you want the hierarchy information.

Value Returned

l_instance-hierarchy
	Returns a list of list (dbInst memInst row column).
nil	The current window is empty or undefined.

Examples

The following example returns ((db:13240512 0 0 0) (db:13402578 1 4 2)).

geGetInstHierPath( hiGetCurrentWindow( ) )

Related Topics

Edit and Display Functions

geGetInstHier

Return to top