Insert VI Method

LabVIEW 2018 Help


Edition Date: March 2018
Part Number: 371361R-01
View Product Info

DOWNLOAD (Windows Only)


LabVIEW 2016 Help
LabVIEW 2017 Help
LabVIEW 2018 Help
LabVIEW 2019 Help
LabVIEW 2020 Help

Short Name: Insert VI

Requires: Base Development System

Class: SubPanel Methods

To Use: Create a method.

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.

Example

Parameters

Data typeNameRequiredDescription
VI RefYesReference to the VI whose front panel you want to load. You can use the Open VI Reference function to obtain a reference to another VI.

Remarks

The following table lists the characteristics of this method.

Data typeNo return value
Available in Run-Time EngineYes (Read/Write)
Available in Real-Time Operating SystemYes
Settable when the VI is runningYes
Loads the front panel into memoryNo
Need to authenticate before useNo
Loads the block diagram into memoryNo
Remote access allowedYes

Example

Refer to the Multiple VIs in a Subpanel VI in the labview\examples\Controls and Indicators\Containers directory for an example of using the Insert VI method.

WAS THIS ARTICLE HELPFUL?

Not Helpful