Get Control Values by Index Function

LabVIEW 2018 Help

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

DOWNLOAD (Windows Only)

LabVIEW 2015 Help
LabVIEW 2016 Help
LabVIEW 2017 Help
LabVIEW 2018 Help
LabVIEW 2019 Help

Owning Palette: Application Control VIs and Functions

Requires: Base Development System

Gets values from the controls for the VI you reference. This function offers better performance than VI Server objects that read from the terminal of a front panel control, such as using the Value property in the Control class. However, this function requires more advanced application design than other methods for getting control values.


VI Refnum specifies a reference to the VI from which you want to get control values. You can wire a strict or non-strict reference to this input. The default is a reference to the current VI.
control indexes specifies an array of indices of front panel controls for which you want to get values. Use the Control Index property in the Control class to retrieve control indexes.
error in describes error conditions that occur before this node runs. This input provides standard error in functionality.
data values returns the control values.
error out contains error information. This output provides standard error out functionality.

Get Control Values by Index Details

The Get Control Values by Index function requires that the VI from which you want to get control values is running or in run mode. Furthermore, the controls for which you want to get values must have terminals on the block diagram.

Note  Because controls nested within clusters or arrays do not have terminals on the block diagram, you cannot get values for those controls.

Application Design Considerations

Use the following recommendations to obtain the best performance when you get control values with this function:

  • Retrieve the index of a control only once during an initialization section of an application.
  • To get control values from the current VI, leave VI Refnum unwired.


Not Helpful