Owning Palette: VI Scripting VI and Functions
Requires: VI Scripting
Adds a new VI object to the front panel or block diagram of the VI specified by owner refnum and returns a reference to the new object. VI objects include any controls, nodes, calls to subVIs, and user-defined controls that you can create in the LabVIEW editing environment.
|auto wire? specifies whether LabVIEW attempts to automatically wire the terminals of the new object with compatible terminals of the source object wired to location. National Instruments recommends that you do not use this input. Instead, use VI Scripting to wire the new object to other objects precisely.|
|vi object class indicates the class of the object you want to create. To specify a class, wire a class specifier constant to this input. A class specifier constant displays a hierarchical menu that contains the classes of all of the objects in LabVIEW. To identify which class to use for a specific object, explore the anatomy of common VI objects.
LabVIEW uses vi object class to determine the type of reference returned by object refnum. For example, if you wire a Boolean-typed class specifier constant to vi object class, the returned object refnum changes to a Boolean reference.
|owner refnum is a reference to the container into which you want to place the new object. The most common containers are VIs, clusters, and the diagrams of loops and other structures. For example, to add a new control to the front panel of a VI, wire a reference to either the relevant VI or the front panel of the relevant VI to owner refnum. To place a new object inside of a For Loop, wire a reference to the diagram of the relevant For Loop to owner refnum.|
|style indicates the exact kind of object to create. When you create a constant from the style terminal, you obtain a list of all the objects that are native to LabVIEW. Select a value for style that is compatible with the class specified by vi object class. For example, you can select the Round Push Button style if viobject class is Boolean, and you can select the Add style if viobject class is Function. However, LabVIEW returns a run time error if you select the Add style when viobject class is Boolean because this pairing is not compatible.|
|location specifies where the function places the new object within the container referenced by owner refnum. The location terminal accepts the following three kinds of arguments:
|error in describes error conditions that occur before this node runs. This input provides standard error in functionality.|
|path is a path to a subVI or pre-existing custom control. Wire data to path only when you want to add one of these objects to the owner.
If you wire data to path, you must set vi object class to Generic»GObject»Node»SubVI or any of the listed parent classes. LabVIEW ignores the style input when you wire path.
|bounds specifies the width and height of the new object if the new object is resizable. LabVIEW ignores bounds for fixed-sized objects.
|object refnum returns a reference to the new object created by this function. The reference is of the class specified by vi object class.|
|error out contains error information. This output provides standard error out functionality.|
Refer to the New VI Object Location Argument VI in the labview\examples\Application Control\VI Scripting\Creating Objects directory for an example of using the New VI Object function.