====== 텍스트 ======

텍스트 위젯은 화면에 문자(문자열)를 표시하는 위젯입니다. \\ 
고정 문구, PLC에서 전달된 문자열, 내부 변수 문자열 등을 표시할 수 있습니다.

{{ :comfilestudio:widget_text:stringdisplay_0.png?nolink |텍스트 위젯이 화면에 배치된 예시입니다.}}

텍스트 소스는 다음과 같이 여러 종류가 있습니다.

  * 직접 지정
  * 필드 리소스
  * 외부 장치 문자열
  * 내부 메모리
  * 유니코드
  * 문자열 연산식

===== 텍스트 소스 : 직접 지정 =====

고정된 문구를 화면에 표시합니다.

{{ :comfilestudio:widget_text:stringprint1.png?nolink |고정 텍스트를 입력하는 설정 화면입니다.}}

예:
  "설비 운전중"
  "READY"

===== 고급 옵션 : 대체 텍스트 =====

특정 조건을 만족하면 기존 텍스트 대신 다른 텍스트를 표시합니다.

{{ :comfilestudio:widget_text:stringprint45.png?nolink |조건에 따라 다른 텍스트를 표시하는 설정 화면입니다.}}

예:

  변수 영문 == 1
  → "Comfile Technology"

  변수 영문 == 0
  → "컴파일 테크놀로지"

{{ :comfilestudio:widget_text:replacetextvideo.mp4?1000x600 |대체 텍스트 동작 예시입니다.}}

다국어 전환 구현 시 매우 유용합니다.

===== 텍스트 소스 : 필드 리소스 =====

필드 리소스에 등록된 텍스트 중 하나를 선택하여 표시합니다.

{{ :comfilestudio:widget_text:stringprint2.png?nolink |필드 리소스를 선택하는 설정 화면입니다.}}

{{ :comfilestudio:widget_text:stringprint3.png?nolink |등록된 텍스트 목록 예시입니다.}}

예:
  리소스 번호 1 → 해당 텍스트 표시

반복 사용되는 문구 관리에 적합합니다.

===== 텍스트 소스 : 외부 장치 문자열 =====

PLC 또는 MCU에서 문자열을 읽어 표시합니다.

주의:
외부 장치 워드에 유니코드 형식으로 저장되어 있어야 합니다.

예:
'ABC' 저장 구조

  0x0041
  0x0042
  0x0043
  0x0000 (종료 코드)

마지막 0x0000은 문자열 끝을 의미합니다.

===== 텍스트 소스 : 내부 메모리 =====

내부 메모리에 저장된 유니코드를 읽어 표시합니다.

{{ :comfilestudio:widget_text:stringprint4.png?nolink |내부 메모리에서 문자열을 읽는 설정 화면입니다.}}

예:

  시작 번지: 6
  최대 표시: 10문자

중간에 0을 만나면 표시를 종료합니다.

===== 텍스트 소스 : 유니코드 =====

유니코드를 직접 입력하여 표시할 수 있습니다.

{{ :comfilestudio:widget_text:stringprintexplain1.png?nolink |유니코드를 직접 입력하는 설정 화면입니다.}}

예:

  65,66,67,68 입력
  → ABCD 표시

{{ :comfilestudio:widget_text:stringprintexplain2.png?nolink |유니코드 입력 결과 예시입니다.}}

===== 텍스트 소스 : 문자열 연산식 =====

내부 문자열 변수 또는 문자열 연산 결과를 표시합니다.

{{ :comfilestudio:widget_text:stringprintexplain3.png?nolink |문자열 연산식을 사용하는 설정 화면입니다.}}

예:

  $a
  $a + $b
  "MODE: " + $mode

동적으로 텍스트를 생성할 수 있습니다.

===== 표시 및 위치 =====

텍스트 위젯의 표시 여부 및 위치를 설정할 수 있습니다.

{{ :comfilestudio:widget_text:locationoptiondisplay.png?nolink |표시 및 위치 옵션 설정 화면입니다.}}

수식을 사용하여 실행 중 위치 변경도 가능합니다.

===== 자주 묻는 질문 =====

Q. 글자가 깨져서 표시됩니다.  
→ 외부 장치 문자열이 유니코드 형식인지 확인하십시오.

Q. 문자열이 중간에서 잘립니다.  
→ 종료 코드(0x0000)가 있는지 확인하십시오.

Q. 다국어 전환을 하고 싶습니다.  
→ 대체 텍스트 기능 또는 필드 리소스를 사용하십시오.

----
키워드: 텍스트 위젯, 문자열 표시, 외부 장치 문자열, 내부 메모리 문자열, 유니코드 표시, 문자열 연산식, 다국어 전환, Comfile Studio 텍스트

[[comfilestudio:index#위젯|상위 페이지로 가기]]