设置引用VI的控件值。与写入前面板控件接线端的VI服务器对象相比，该函数提供了更好的性能。例如，使用控件类的值属性。但与其他设置控件值的方法相比，该函数要求更为高级的应用程序设计。


icon

输入/输出

  • cvirn.png VI引用句柄 —

    VI引用句柄是要设置多个控件值的VI的引用。可连接一个严格或非严格引用至该输入。默认值为当前VI的引用。

  • c1di32.png 控件索引 —

    控件索引要设置其值的前面板控件的索引。

    使用控件类的控件索引获取控件索引。
  • c1dfxdt.png 数据值 —

    数据值为写入控件的值。默认为一个变体，也可指定要写入控件的值的数据类型。指定单个控件时，应将一个标量索引连接至控件索引，并连接单个值至数据值。

  • cerrcodeclst.png 错误输入（无错误） —

    错误输入表明该节点运行前发生的错误条件。该输入将提供标准错误输入功能。

  • ierrcodeclst.png 错误输出 —

    错误输出包含错误信息。该输出提供标准错误输出功能。

    • “按索引设置控件值”要求设置控件值的VI正在运行或处于运行模式。同时，要设置值的控件必须在程序框图上有接线端。

    注： 由于嵌套在簇或数组中的控件在程序框图上没有接线端，所以无法设置这类控件的值。

    该函数将重复循环连接至控件索引和数据值两个数组中较短的长度。函数尝试设置所有值，且不在第一个错误停止。如多个索引或值发生错误，LabVIEW仅报告第一个错误。

    应用程序设计注意事项

    遵循下列建议，使通过该函数设置控件值时获得最佳性能：

    • 在应用程序初始化部分仅提取一次控件的索引。
    • 如需设置当前VI的控件值，可不连线VI引用句柄。
    • 在单次调用中设置多个值以减少开销。
    • 如需设置一组相同数据类型的控件值，可连线该数据类型的数组至数据值。例如，连线64位双精度浮点数的数组至数据值，可更新一组表示法为64位双精度浮点的数值控件。