지역화된 텍스트의 번역 범위

지역화된 텍스트의 번역은 UI 세션과 현재 로케일에 따라 달라집니다.

개요

LocalizedText
 변수의 번역은 세션 언어에 따라 달라지며 로케일 인식 UI 세션에서만 발생합니다.
로케일 인식 UI 세션은 현재 로케일에 대해
지역화사전
 항목을 사용합니다. UI 세션 외부의 개체는 현재 세션 로케일을 사용하지 않습니다.
다음 규칙은 UI 세션과 루트 세션에서의 번역 동작을 설명합니다.
  • 번역은 로케일 인식 UI 세션에서만 적용됩니다.
  • 리터럴 문자열은 자동으로 번역되지 않습니다.
  • 텍스트는 지역화 항목과 일치하는 경우에만 번역됩니다.
  • UI 세션 외부의 개체는 루트 세션 로케일을 사용합니다.
  • 루트 세션 로케일은 기본적으로 영어입니다.

번역 범위

다음 개체와 컨텍스트는 번역에 현재 세션 로케일을 사용합니다.
번역 가능한 개체 및 컨텍스트
항목
설명
지역화사전
의 키에 대한 링크가 있는 레이블 또는 텍스트 상자와 같은 UI 개체
개체는 UI 세션에서 실행되며 현재 로케일을 사용합니다.
연결된 키에 현재 로케일에 대한 항목이 있으면 UI 개체에 번역된 텍스트가 표시됩니다.
문자열포맷터
 컨버터와
지역화사전
 키에 연결된
Format
 속성이 있는 UI 개체
그래픽 개체가
문자열포맷터
를 사용하는 경우,
Format
 속성이 사전 항목과 일치하면 UI가 콘텐츠를 번역합니다. 이 동작은 로케일별 문장 구조를 지원합니다.
예를 들어, 한 로케일은
Value: {0}
 형식을 사용할 수 있고, 다른 로케일은
{0}：値
 형식을 사용할 수 있습니다.
지역화 사전 키에 대한 링크가 있는
LocalizedText
 유형의 모델 변수에 연결된 UI 개체
UI 개체는 변수 값이 지역화 사전 항목과 일치할 때 현재 로케일의 번역을 표시합니다.
다음 개체 및 컨텍스트는 번역에 현재 세션 로케일을 사용하지 않습니다.
번역할 수 없는 개체 및 컨텍스트
항목
설명
프로젝트 내 위치와 관계없이 리터럴 문자열 값
모델 변수가 리터럴 문자열을 보유하는 경우, 해당 문자열은 런타임에 자동으로 번역되지 않습니다. 이 동작은 프로젝트 기본 로케일에 따라서도 변경되지 않습니다.
프로젝트 내 위치나 데이터 유형과 관계없이, 직접적인 지역화 사전 항목이 없는 모든 변수
지역화 사전 항목이 없는 변수는 번역되지 않습니다.
예를 들어, 사전 매핑이 없는
hello
 텍스트가 있는 레이블은 변경되지 않은 상태로 유지됩니다.
UI 개체 외부에서
문자열포맷터
 컨버터와 지역화된
Format
 속성을 사용하는
LocalizedText
 유형의 변수
Format
 속성이 지역화 키와 일치하더라도 변수가 UI 개체 외부에 있으면 번역이 수행되지 않습니다.
예를 들어 일부 개체에는 적용되지 않습니다. 경보, 이벤트로거, 보고서.
의견을 작성 부탁드립니다.
이 자료에 대한 문의사항이나 요청사항이 있습니까? 여기에 요청사항을 작성 부탁드립니다.
Normal