참조하는 VI에 대한 컨트롤 값을 설정합니다. 이 함수는 컨트롤 클래스의 값 프로퍼티를 사용하는 것과 같이, 프런트패널 컨트롤의 터미널에 값을 쓰는 VI 서버 객체보다 더욱 우수한 성능을 제공합니다. 그러나 이 함수는 컨트롤 값 설정에 사용되는 다른 메소드보다 더 고급의 어플리케이션 디자인을 필요로 합니다.


icon

입력/출력

  • cvirn.png VI 참조 번호 —

    VI 참조 번호는 여러 컨트롤 값을 설정하려는 VI의 참조를 지정합니다. 엄격한 또는 엄격하지 않은 참조를 이 입력에 연결할 수 있습니다. 기본은 현재 VI의 참조입니다.

  • c1di32.png 컨트롤 인덱스 —

    컨트롤 인덱스는 값을 설정하려는 프런트패널 컨트롤의 인덱스를 지정합니다.

    컨트롤 클래스의 컨트롤 인덱스 프로퍼티를 사용하여 컨트롤 인덱스를 가져옵니다.
  • c1dfxdt.png 데이터 값 —

    데이터 값은 컨트롤에 쓸 값을 지정합니다. 기본은 배리언트이지만, 컨트롤에 쓰려는 값의 데이터 타입을 지정할 수도 있습니다. 한 개의 컨트롤을 지정하려면, 컨트롤 인덱스에 스칼라 인덱스를 연결하고 데이터 값에 한 개의 값을 연결합니다.

  • cerrcodeclst.png 에러 입력(에러 없음) —

    에러 입력은 이 노드의 실행 전에 발생한 에러 조건을 설명합니다. 이 입력은 표준 에러 입력 기능을 제공합니다.

  • ierrcodeclst.png 에러 출력 —

    에러 출력은 에러 정보를 포함합니다. 이 출력은 표준 에러 출력 기능을 제공합니다.

    • [컨트롤 값 인덱스로 설정] 함수를 사용하려면 컨트롤 값을 설정하려는 VI가 실행 중이거나 실행 모드여야 합니다. 또한 값을 설정하려는 컨트롤이 블록다이어그램에 터미널을 가지고 있어야 합니다.

    노트 클러스터나 배열 안에 있는 컨트롤은 블록다이어그램에 터미널을 갖고 있지 않기 때문에, 이들 컨트롤의 값은 설정할 수 없습니다.

    이 함수는 컨트롤 인덱스 및 데이터 값에 연결한 두 개 배열 중 보다 짧은 배열에 해당하는 길이만큼 반복됩니다. 이 함수는 모든 값을 설정하려 시도하고 첫번째 에러에서 정지하지 않습니다. 여러 인덱스 또는 값에서 에러가 발생하는 경우, LabVIEW는 첫번째 에러만 보고합니다.

    어플리케이션 디자인 고려사항

    이 함수로 컨트롤 값을 설정할 때 성능을 최대한 높이려면 다음 권장 사항을 따르십시오:

    • 어플리케이션의 초기화 섹션에서는 한 번만 컨트롤의 인덱스를 가져옵니다.
    • 현재 VI의 컨트롤 값을 설정하려면, VI 참조 번호를 연결하지 마십시오.
    • 단일 호출로 여러 값을 설정하여 오버헤드를 최소화합니다.
    • 데이터 타입이 같은 컨트롤 그룹에 대해 값을 설정하려면, 해당 데이터 타입의 배열을 데이터 값에 연결합니다. 예를 들어, 64비트 배정도 부동소수 형인 숫자형 컨트롤 그룹을 업데이트하려면 데이터 값에 64비트 배정도 부동소수의 배열을 연결합니다.