문자열 테이블은 문자열에 인덱스를 지정하여 테이블 방식으로 저장하는 기능입니다. 저장된 문자열은 문자열값 오브젝트를 통해 표시되며, 사용자가 미리 지정한 태그 값에 따라 내용을 변경할 수 있습니다. 또한 그룹을 설정함으로써 그룹마다 다른 문자열들을 저장할 수 있습니다.
※ 문자열값 오브젝트는 ‘문자열값 오브젝트’ 도움말을 참조하여 주시기 바랍니다.
NOTE | 본 도움말은 XpanelDesigner V2.52를 기준으로 작성되었습니다. 사용 중인 XpanelDesigner 버전에 따라 지원하는 기능에 차이가 있을 수 있는 점 유의하시기 바랍니다. |
설정 화면
[도구]-[문자열 테이블]을 선택하면 다음과 같이 설정 화면이 나타납니다.
(1) 문자열 그룹 추가
문자열 테이블 하나를 저장할 그룹을 생성합니다.
버튼을 누르면 다음과 같은 화면이 나타납니다.
항목 | 내용 |
단일 칼럼 | 하나의 인덱스에 하나의 칼럼을 설정합니다. 태그 값 하나 당 하나의 문자열을 설정할 때 사용할 수 있습니다. |
다중 칼럼 | 하나의 인덱스에 다수의 칼럼을 설정합니다. 태그 값 하나 당 최대 16 개의 문자열을 설정할 수 있습니다. 다국어 테이블을 설정하고자 할 때 사용할 수 있습니다. ※ 다국어 테이블 설정에 대한 자세한 내용은 ‘다국어 설정’ 도움말을 참조해주시기 바랍니다. |
그룹 번호. | 테이블 하나를 저장할 그룹의 번호를 설정합니다. 0에서 32767까지 지정 가능합니다. 중복되는 그룹 번호는 설정할 수 없습니다. 그룹 번호 지정 이후, 더블클릭하여 다른 번호로 변경할 수 있습니다. |
그룹 제목 | 그룹 제목을 입력합니다. 입력한 그룹 제목은 더블클릭하여 다른 이름으로 변경할 수 있습니다. |
※ 그룹 번호, 그룹 제목 변경 기능은 XpanelDesigner v2.53 이상 버전에서 사용할 수 있습니다.
(2) 문자열 그룹 삭제
버튼을 눌러 선택한 문자열 테이블 그룹을 삭제합니다. 그룹 내에 문자열이 설정되어 있을 경우, 설정된 문자열 또한 삭제되는 점 유의해주시기 바랍니다.
(3) 문자열 추가
버튼을 눌러, 선택한 칼럼의 종류에 따라 문자열을 그룹에 추가합니다. 이 때, 디지털 태그와 아날로그 태그를 그룹에 연결할 수 있습니다.
단일 칼럼을 선택하였을 경우, 각 태그 값에 하나의 칼럼을 저장할 수 있습니다. 이 때, 디지털 태그의 경우 0 과 1 값을 지정할 수 있으며, 아날로그 태그의 경우 -32768 부터 32767 값을 지정할 수 있습니다. 문자열값 오브젝트를 통해 내용을 표시할 수 있습니다.
다중 칼럼을 선택하였을 경우에는 지정된 태그 값마다 0 번부터 15 번까지, 총 16 개의 칼럼을 저장할 수 있습니다. 이 때, 디지털 태그의 경우 칼럼 0 과 칼럼 1 에 있는 내용만이 표시됩니다. 아날로그 태그를 설정하였을 경우, 태그 값이 0 에서 15 까지의 값으로 변경되면 해당 번호의 칼럼이 출력됩니다. 다국어 문자열 오브젝트를 통해 내용을 표시할 수 있습니다.
(4) 문자열 편집
문자열을 선택하고 편집 버튼을 누르거나, 선택한 문자열을 더블클릭하여 수정할 수 있습니다. [문자열 추가]와 동일한 화면이 나타나며, 값과 문자열을 변경할 수 있습니다.
(5) 문자열 삭제
삭제 버튼을 눌러 선택한 문자열을 삭제할 수 있습니다. 문자열 테이블의 인덱스를 마우스로 드래그하여 다중 선택 후 일괄적으로 삭제할 수 있습니다.
(6) 칼럼 속성 설정
[도구]-[다국어 설정]에서 ‘다국어 테이블 사용’ 옵션을 선택하였을 때 사용할 수 있습니다. 각 칼럼에 해당하는 언어와, 해당 언어를 표시할 글꼴을 지정할 수 있습니다.
※ 다국어 설정에 대한 자세한 내용은 ‘다국어 설정’ 도움말을 참조해주시기 바랍니다.
1.1.2 관련 기능
본 항목에서는 문자열 테이블 기능에서 자주 쓰이는 함수를 설명합니다. 다음 표를 참조해주시기 바랍니다.
명령식 | 설명 | ||
문자열 테이블 | 함수 | StringTable | 문자열 테이블에서 취득한 문자열을 출력합니다. |
StringTable | 문자열 테이블에서 취득한 문자열을 출력합니다. |
함수명 | n = StringTable (“그룹번호”, “그룹 내 문자열 번호”) |
기능 | 문자열 테이블에서 설정한 그룹을 지정한 후, 그룹 내의 문자열 데이터를 취득합니다. 이 때, 해당되는 문자열 데이터에는 반드시 문자열 태그를 지정하여야 합니다. |
사용 예제 | 문자열 태그가 사용되었을 때, 그룹 1번의 1번째 문자열을 출력합니다. StrTag = StringTable (1, 1) |
사용 예제
본 예제는 기능을 설명하기 위해 삽입된 예제입니다. 실제 사용 시 사용자의 환경에 맞게 설정하여 사용해주십시오. |
사용 예제 : 아날로그 태그값 변경에 따른 문자열값 확인 |
아날로그 태그의 값이 변화하였을 때 각 수조의 상태에 해당되는 문자열을 다르게 표시하는 예제입니다.
a) 데이터베이스에서 아날로그 태그 ‘VALUE’를 생성합니다.
b) [도구]-[문자열 테이블]을 선택하여 문자열 테이블에 진입합니다. ‘그룹0’ 내에서 표시할 내용을 설정합니다.
‘VALUE’ 태그의 값이 0일 때, ‘수조에 물이 없습니다.’ 문자열이 표시됩니다.
‘VALUE’ 태그의 값이 1일 때, ‘수조 내 물이 저장되었습니다.’ 문자열이 표시됩니다.
‘VALUE’ 태그의 값이 2일 때, ‘수조에 물이 가득 찼습니다.’ 문자열이 표시됩니다.
c) [그림] – [문자열값]을 선택 후 페이지에 등록합니다. 아날로그 태그 ‘VALUE’를 등록하고, 문자열그룹을 ‘0’으로 지정합니다.
d) [그림] – [스위치/램프]를 선택한 후, 워드 스위치로 설정합니다. ‘태그 연산’ 동작을 선택하여 스위치를 클릭할 때마다 ‘VALUE’ 태그에 1 값이 더해지도록 합니다.
e) Xpanel 또는 Xpanel 시뮬레이터를 실행하여 동작을 확인합니다. ‘VALUE’ 태그의 값 변화에 따라 문자열 테이블에서 설정한 내용이 문자열값 오브젝트로 표시됩니다.
NOTE | 문자열 테이블 내에 디지털 또는 아날로그 태그의 현재값에 해당하는 문자열이 설정되지 않았을 경우, 문자열은 출력되지 않습니다. |
사용 예제 : 문자열 태그를 사용한 문자열 테이블 내용 확인 |
문자열값 오브젝트 대신 문자열 태그를 사용하는 것으로도 문자열 테이블의 내용을 표시할 수 있습니다. 다음 예제를 참조하여 주시기 바랍니다.
a) 데이터베이스에서 문자열 태그 ‘STR’을 생성합니다.
b) [도구]-[문자열 테이블]을 선택하여 문자열 테이블에 진입합니다. ‘그룹 1’ 내에서 1번 문자열에 표시할 내용을 설정합니다.
c) [도구]-[스크립트]를 선택하여 다음과 같이 스크립트를 작성합니다.
d) [그림] – [태그값]을 선택하여, 문자열 데이터를 표시할 태그값 오브젝트를 등록합니다.
e) 프로젝트를 Xpanel 또는 시뮬레이터에서 실행하여 동작을 확인합니다. 문자열 테이블에서 설정한 문자열 데이터가 태그값 오브젝트에 나타납니다.
NOTE | 문자열 태그로 표시할 수 있는 문자열의 길이는 최대 80자까지입니다. 문자열 태그의 길이는 태그의 ‘고급 설정’ 탭에서 설정 가능합니다. |