hiIsInstantiated

hiIsInstantiated( 
g_formRegionOrMenu 
) 
=> t / nil 

Description

Displays a form at least once or a menu has been placed in a window. Returns nil if the form has been deleted or if g_formRegionOrMenu is not valid.

Argument

g_formRegionOrMenu
	A form, scroll region, tab page, or menu.

Values Returned

t	The item has been displayed and/or can be used interactively.
nil	The item is not instantiated.

Examples

After creating a form, scroll region, tab page, or menu, the item only exists as a SKILL construct and does not verify changes made to it or its fields/menu items, and does not call callbacks when changes are made.

After the item is displayed the first time or otherwise explicitly instantiated (made interactive), hiIsInstantiated returns t and the callbacks works until the item such as form is deleted.

MyForm = hiCreateAppForm( ?name 'MyForm ?dontBlock t <other form arguments> )

=> formStruct@0x8d0aea8

hiIsInstantiated( MyForm )

=> nil

hiDisplayForm( MyForm )

=> t

hiIsInstantiated( MyForm )

=> t

hiFormDone( MyForm )

=> t

hiIsInstantiated( MyForm )

=> t

hiDeleteForm( MyForm )

=> t

hiIsInstantiated( MyForm )

=> nil

Related Topics

Form and Field Functions

Return to top