Alcance de traducción del texto localizado

La traducción del texto localizado depende de la sesión de interfaz de usuario y de la configuración regional actual.

Información general

La traducción de las variables
LocalizedText
 depende del idioma de la sesión y solo se produce en una sesión de interfaz de usuario con reconocimiento de configuración regional.
Una sesión de interfaz de usuario con reconocimiento de configuración regional usa entradas de
LocalizationDictionary
 para la configuración regional actual. Los objetos fuera de la sesión de interfaz de usuario no usan la configuración regional actual de la sesión.
Las siguientes reglas describen el comportamiento de la traducción en la sesión de interfaz de usuario y en la sesión raíz:
  • La traducción solo se aplica en sesiones de interfaz de usuario con reconocimiento de configuración regional.
  • Las cadenas literales no se traducen automáticamente.
  • El texto se traduce solo cuando coincide con una entrada de localización.
  • Los objetos fuera de la sesión de interfaz de usuario usan la configuración regional de la sesión raíz.
  • La configuración regional de la sesión raíz es el inglés de forma predeterminada.

Alcance de la traducción

Los siguientes objetos y contextos usan la configuración regional actual de la sesión para la traducción.
Objetos y contextos traducibles
Elemento
Descripción
Objeto de interfaz de usuario, como una etiqueta o un cuadro de texto, con un vínculo a una clave de
LocalizationDictionary
El objeto se ejecuta en la sesión de interfaz de usuario y usa la configuración regional actual.
El objeto de interfaz de usuario muestra texto traducido cuando la clave vinculada tiene una entrada para la configuración regional actual.
Objeto de interfaz de usuario con un convertidor
StringFormatter
 y una propiedad
Format
 vinculada a una clave de
LocalizationDictionary
Si un objeto gráfico usa
StringFormatter
, la interfaz de usuario traduce el contenido cuando la propiedad
Format
 coincide con una entrada del diccionario. Este comportamiento admite una estructura de oración específica de la configuración regional.
Por ejemplo, una configuración regional puede usar
Value: {0}
, y otra configuración regional puede usar
{0}：値
.
Objeto de interfaz de usuario vinculado a una variable de modelo de tipo
LocalizedText
 con un vínculo a una clave de diccionario de localización
El objeto de interfaz de usuario muestra la traducción de la configuración regional actual cuando el valor de la variable coincide con una entrada del diccionario de localización.
Los siguientes objetos y contextos no utilizan la configuración regional de la sesión actual para la traducción.
Objetos y contextos intraducibles
Elemento
Descripción
Valores de cadena literales, independientemente de su ubicación en el proyecto
Si una variable de modelo contiene una cadena literal, la cadena no se traduce automáticamente en tiempo de ejecución. Este comportamiento no cambia con la configuración regional predeterminada del proyecto.
Cualquier variable sin una entrada directa en el diccionario de localización, independientemente de su ubicación en el proyecto o del tipo de datos
Las variables sin una entrada en el diccionario de localización no se traducen.
Por ejemplo, una etiqueta con texto
hello
 sin asignación de diccionario permanece sin cambios.
Variable de tipo
LocalizedText
 que usa un convertidor
StringFormatter
 y una propiedad
Format
 localizada fuera de un objeto de interfaz de usuario
Si la propiedad
Format
 coincide con una clave de localización, pero la variable está fuera de un objeto de interfaz de usuario, no se produce la traducción.
No se aplica a algunos objetos, por ejemplo: Alarmas, EventLoggers, informes.
Entregue su opinión
¿Tiene dudas o comentarios acerca de esta documentación? Por favor deje su opinión aquí.
Normal