# 지역 변수

지역 변수는 해당 지역 변수가 설정된 화면이나 콘텐츠, 스크립트 안에서만 액세스할 수 있는 내부 변수입니다. 지역 변수는 해당 화면/콘텐츠 안에서만 사용할 수 있으므로 임시 데이터에 편리합니다.

Hide Show

1. 지역 변수의 최대 수
2. 이름 지정 및 데이터 형식
3. 데이터 바인딩
4. 지역 변수 복사하기
5. 지역 변수와 연결된 개체 복사하기
6. 기타

## 지역 변수의 최대 수

지역 변수는 화면 편집 소프트웨어에서 화면/콘텐츠당 300개까지 구성할 수 있습니다. 화면에 콘텐츠 표시가 있고 화면에 있는 지역 변수의 총수 및 콘텐츠 표시와 연결된 콘텐츠의 지역 변수가 3600을 초과하면 오류가 발생합니다.

지역 변수의 최대 수는 표시 모델에 따라 다릅니다. 프로젝트당 지역 변수의 최대 수는 프로젝트당 전역 변수의 최대 수에 포함되지 않습니다.

각 표시 모델에 대한 지역 변수의 최대 수에 관한 자세한 내용은 다음을 참조하십시오.

대응 모델/기능 리스트

런타임에 그려지는 화면에 로드할 수 있는 지역 변수의 최대 수는 3600개입니다. 3600개의 지역 변수 한도가 초과되면 그리기가 중지되고 시스템 오류가 표시됩니다.

메모:

- 슬라이드 콘텐츠 표시나 슬라이드 탐색을 위하여 스크롤 제스처로 화면/콘텐츠를 변경하는 경우 현재 표시되지 않은 이전 및 다음 화면/콘텐츠에 설정된 로컬 변수도 상한 계산에 포함됩니다.

- 어떤 개체가 그 개체의 현재 [가시] 설정 탓에 런타임 시 표시되지 않아도 그 개체에 설정된 지역 변수도 상한 계산에 포함됩니다.

- 콘텐츠 표시 개체나 슬라이드 콘텐츠 표시 개체의 [콘텐츠 ID]를 간접적으로 지정하면 화면 편집 소프트웨어에서 그 콘텐츠의 지역 변수를 계수할 수 없습니다. 따라서 화면 편집 소프트웨어에 오류가 없어도 런타임에 지역 변수 한도가 초과되어 콘텐츠가 표시되지 않을 수도 있습니다. 그런 경우가 발생하면 시스템 오류가 표시됩니다.

## 이름 지정 및 데이터 형식

지역 변수 이름은 화면/콘텐츠 안에서 고유한 것이어야 합니다. 지역 변수 이름의 명명 규칙에 관한 자세한 내용은 다음을 참조하십시오.

명명 규칙

지역 변수가 지원하는 데이터 형식은 WSTRING을 제외하고 기본 변수와 같습니다. 사용자 데이터 형식 변수에 대한 데이터 형식도 지원되지 않습니다. 데이터 형식에 관한 자세한 내용은 다음을 참조하십시오.

데이터 종류

전역 변수는 지역 배열 변수의 요소 번호로 사용할 수 없습니다.

## 데이터 바인딩

개체의 속성을 지역 변수와 연결할 수 있습니다. 지역 변수는 화면/콘텐츠 안에서만 사용할 수 있으므로 임시 데이터에 편리합니다. 지역 변수와 연결할 때 접두사 “$Local”이 추가됩니다. 예: $Local.Var1.Value

지역 변수는 알람, 데이터 로깅, USB 바코드 판독기, OPC UA 등 전역 기능에 사용할 수 없으므로 전역 기능에는 반드시 전역 변수를 사용해야 합니다. 데이터 바인딩 관한 자세한 내용은 다음을 참조하십시오.

데이터 바인딩

## 지역 변수 복사하기

전역 변수를 지역 변수에 복사하거나 그 반대로 복사할 수 있습니다.

전역 변수를 지역 변수에 복사하는 경우 관련 속성이 복사됩니다. 지역 변수를 전역 변수에 복사하는 경우 기본값이 속성에 설정되어 지역 변수에서 사용할 수 없습니다.

## 지역 변수와 연결된 개체 복사하기

지역 변수와 연결된 개체를 또 다른 화면에 복사할 수 있습니다.

대상 화면에 이름이 같은 지역 변수가 없으면 [경고] 대화 상자가 표시됩니다.

개체를 붙여넣으려면 [붙여넣기] 버튼을 선택합니다.

개체 및 그 개체와 연결된 지역 변수를 붙여넣으려면 [바인딩으로 붙여넣기]를 선택합니다.

대상 화면에 이름이 같은 지역 변수가 있으면 해당 개체가 붙여넣어지고 대상 화면의 지역 변수가 복사된 개체와 연결됩니다. 지역 변수의 데이터 형식이 일치하지 않으면 빌드 시 오류가 발생합니다.

## 기타

지역 변수는 OPC UA 서버나 웹 API/WebSocket을 사용하여 읽거나 쓸 수 없습니다.