geGetInstHier

geGetInstHier( 
[ w_windowId ] 
)
=> t_instance-hierarchy / nil 

Description

Returns a string 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 string is in the form:

/dbinst1/dbinst2/dbinst3/... 

Slashes separate the string into components. Each component represents the name of the instance and possibly the 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 string returned by geGetInstHier is /.

The results of this function can be used in the Hierarchy item in the Open Design form.

Arguments

w_windowId

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

Value Returned

t_instance-hierarchy
	Instance hierarchy description for this window.
nil	The current window is empty or the current window is undefined

Examples

The following example returns /db:13240512/db:13405278.

geGetInstHier( getCurrentWindow( ) )

Related Topics

Edit and Display Functions

geGetInstHierPath

Return to top