Product Documentation
Virtuoso ADE SKILL Reference
Product Version IC23.1, November 2023

asiSelectInst

asiSelectInst(
s_field
[ ?prompt t_prompt ]
[ ?form r_form ]
[ ?tab l_tab ]
)
=> t / nil

Description

Lets you select an instance from the schematic. If you select any other object, the system beeps and ignores the selection.

Arguments

s_field

Name of the field to be filled in with the selected value.

?prompt t_prompt

Prompt string to display in the schematic window.

Default Value: "Select instance..."

?form r_form

Form that contains the field to be filled in with the selected value. The default is the form returned by hiGetCurrentForm.

?tab l_tab

List containing the following:

  • Name of the tab, which is created using hiCreateTabField.
  • Page displayed on the specified tab on which the string field exists.
Use this argument only in case the specified form has multiple tabs.

Value Returned

t

Successful operation

nil

Indicates an error.

Examples

Lets you select an instance from the schematic to use as input for the inst1 field of the current form. It is used when the form does not contain any tabs.

asiSelectInst( 'inst1 )

Lets you select an instance inst1 which is present in page1 of TabField. It is used when a form contains multiple tabs.

asiSelectInst('inst1 ?tab list('TabField 'page1))

Related Topics

hiCreateTabField

hiGetCurrentForm


Return to top
 ⠀
X