You are here: NI Home > Support > Product Reference > Manuals > LabVIEW 8.2 Help

Method of SubPanel.

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.

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. Examples

Parameters

Name	Description
VI Ref	Reference 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.

Settable when the VI is running	Yes
Need to authenticate before use	No
Loads the block diagram into memory	No
Remote access disallowed	No
Loads the front panel into memory	No
Must wait until user interface is idle	No
Available with control VIs	No
Available with global VIs	No
Available with strict type definitions	No
Available with polymorphic VIs	No
Available in Run-Time Engine and Real-Time Operating System	Yes (Read/Write)

Examples

Refer to the following VIs for examples of using the Insert VI method:

• labview\examples\general\controls\subpanel.llb\Subpanel Viewer.vi

   

• labview\examples\general\controls\subpanel.llb\Simple Subpanel.vi

   

• labview\examples\general\controls\subpanel.llb\Subpanel Templates.vi