SubPanel class/Insert VI method

From LabVIEW Wiki
Jump to: navigation, search
VI Server Method Information
Method ID 72583C00
Scope Basic Development Environment
Data Name Insert VI
Short Name* Insert VI
Long Name* Insert VI
* Displayed here in English. Short and Long names appear in the language of the LabVIEW IDE.
Owning Class ID 65
Owning Class Name SubPanel Class
Return Data Type No return value
Invoke Node Insert VI
Available in Real-Time Operating SystemYes
Available in Run-Time EngineYes (Read/Write)
Loads the block diagram into memoryNo
Loads the front panel into memoryNo
Need to authenticate before useNo
Remote access allowedYes
Settable when the VI is runningYes

Loads a VI in the subpanel control without changing the state of the VI.

If the front panel of the VI you want to load is open or if you loaded the front panel in another subpanel control on the same front panel, LabVIEW returns an error, and you cannot load the front panel in the subpanel control unless the front panel is reentrant. You also cannot load the front panel of a VI in a remote application instance, and you cannot load front panels recursively.

LabVIEW also returns an error if you wire a custom control to this method. To wire a custom control to a subpanel, place the control on the front panel of a VI. Then wire that VI to the subpanel.

After you use this method, the front panel is in memory. Use the Close Reference function to close the VI reference. The front panel remains in the subpanel control until you stop the VI that contains the subpanel control. You also can use the Remove VI method to unload the VI in the subpanel control.

Parameters

Data type Name Required Description
VI Refnum VI Ref Yes Reference to the VI whose front panel you want to load.

Uses

History

Version Change(s)
LabVIEW 2018 More info to come.

See Also

External Links