AYUDA EN LÍNEA
 WINDEV, WEBDEV Y WINDEV MOBILE
¡Nueva funcionalidad de WINDEV 2024!
Ayuda / Tutorial WINDEV / Tutorial - Gestionar varios idiomas
  • Adaptar una aplicación a varios idiomas
  • ¿Qué es una aplicación multilingüe?
  • Ejemplo práctico: integrar varios idiomas en una aplicación
  • Etapa 1: Elegir los idiomas que admite el proyecto
  • Etapa 2: Elegir los idiomas en el análisis
  • Agregar idiomas en el análisis
  • Información multilingüe compartida
  • Aplicar los cambios
  • Etapa 3: Adaptar los diferentes elementos del proyecto a varios idiomas
  • Utilizar una imagen multilingüe
  • Traducir controles
  • Traducir textos de programación
  • Traducir menús y opciones de menú
  • Etapa 4: Cambiar el idioma mediante programación
  • Agregar una opción de menú
  • Programación
  • Prueba de un proyecto multilingüe
  • Información adicional: Herramientas de traducción
  • Introducir las traducciones directamente
  • Traducción con WDMSG y WDTRAD
  • Otros elementos a traducir: mensajes del framework

Tutorial - Gestionar varios idiomas

Adaptar una aplicación a varios idiomas
Abordaremos los siguientes temas:
  • ¿Qué es una aplicación multilingüe?
  • Crear una aplicación multilingüe, paso a paso.
Durée de la leçon 20 min
¿Qué es una aplicación multilingüe?
Una aplicación multilingüe es una aplicación que puede ejecutarse en diferentes idiomas (español, inglés, francés, alemán u otro).
Es decir, la misma aplicación se puede utilizar en varios idiomas. Veamos cómo se hace.
Vamos a usar un proyecto que puede ejecutarse en inglés o francés, según la decisión del usuario.
Ejemplo práctico: integrar varios idiomas en una aplicación
Supongamos que hemos desarrollado una aplicación con una UI en un idioma (por ejemplo, inglés), pero necesitamos realizar algunos cambios para que sea compatible con otro idioma (por ejemplo, francés).
Estos cambios deben seguir diferentes etapas en un orden específico. La primera etapa consiste en indicar que el proyecto admite varios idiomas. Esta etapa es esencial para desarrollar una aplicación multilingüe.
Veamos las principales etapas para desarrollar una aplicación WINDEV multilingüe. Las etapas son las siguientes:
  • Elegir los idiomas que admite el proyecto.
  • Elegir los idiomas que admite el análisis.
  • Implementar los idiomas en los distintos elementos del proyecto (ventanas, reportes, controles, ayuda, etc.).
  • Adoptar los métodos para traducir texto en el código.
  • Cambiar el idioma de la aplicación mediante programación.
Para poner en práctica estas etapas, utilizaremos el proyecto "WD Full Application". Este proyecto está en inglés y vamos a traducirlo al francés.
Abrir el proyecto de ejemplo
  1. Vaya a la página de inicio de WINDEV (Ctrl + <).
  2. En la página de inicio, haga clic en "Tutorial", luego en "Tutorial - WINDEV application: Manage data", haga doble clic en "Full application - Answers".
Etapa 1: Elegir los idiomas que admite el proyecto
La primera etapa consiste en definir los idiomas que admite el proyecto. En este ejemplo, la aplicación estará en inglés y francés.
  1. Abra la descripción del proyecto: en la pestaña "Proyecto", en el grupo "Proyecto", haga clic en "Descripción".
  2. Haga clic en la pestaña "Idiomas".
  3. Haga clic en "Agregar". La ventana de selección de idiomas se abre.
    Seleccionar los idiomas del proyecto
  4. Haga clic en "Francés". A la derecha del idioma aparece una marca de verificación.
  5. Valide. El idioma "Francés" aparece en la lista de idiomas del proyecto.
La pestaña "Idiomas" también permite configurar las opciones de idioma para números, divisas, fechas, etc., en el idioma seleccionado. Veamos un ejemplo:
  1. Haga clic en "Francés".
  2. Seleccione la pestaña "Fecha".
  3. De forma predeterminada, se utilizan las opciones de idioma de Windows. Seleccione la opción "Utilizar los siguientes parámetros" para definir el formato de la fecha y la traducción de los días y meses.
  4. Conserve la opción "Utilizar la configuración definida en las opciones de idioma del sistema operativo".
En las opciones de idioma, puede elegir la dirección del texto (pestaña "Varios", opción "Dirección de escritura"). Esto le permite crear interfaces con un idioma escrito de derecha a izquierda.
Ahora, solo queda aplicar los cambios:
  1. Valide la ventana de descripción del proyecto.
  2. Un mensaje le pide que sincronice los diferentes elementos del proyecto. Responda "Sí".
Todos los elementos del proyecto abiertos en el editor (ventanas, reportes, etc.) se cierran y los idiomas adicionales se agregan a estos elementos.
Observación: Los títulos que existen en el idioma de origen del proyecto se copian automáticamente a los idiomas agregados.
Etapa 2: Elegir los idiomas en el análisis
De forma predeterminada, un análisis se crea en un idioma específico y no se puede traducir.
Sin embargo, alguna información puede introducirse en varios idiomas (notas de la documentación, información compartida, etc.).
Si la aplicación utiliza Reports and Queries, también se pueden traducir los nombres de los archivos de datos y de los campos. Estos elementos pueden traducirse en la pestaña "Reports and Queries".
¿Por qué traducir los datos del análisis?
De forma predeterminada, los controles creados a partir de los campos del análisis tienen el texto del campo especificado en el análisis. Si se especificó un título en la información compartida del campo, este se utilizará al crear el control. En un proyecto multilingüe, esta información debe traducirse para que los nuevos elementos estén en todos los idiomas necesarios.
Cuando se cambia el idioma del proyecto relacionado con el análisis, este cambio no se aplica automáticamente al análisis, dado que los análisis pueden estar compartidos entre varios proyectos.

Para descubrir cómo funciona, primero vamos a agregar los idiomas en el análisis y, a continuación, introduciremos la información compartida en varios idiomas.

Agregar idiomas en el análisis

Para utilizar varios idiomas en el análisis de la aplicación WD Full Application:
  1. Abra el editor de análisis: haga clic en Cargar análisis del proyecto en los botones de acceso rápido del menú de WINDEV.
  2. En la descripción del análisis (opción "Descripción del análisis" del menú contextual), seleccione la pestaña "Idioma".
  3. La lista de idiomas del análisis aparece. Como el francés no está en la lista, tenemos que agregarlo:
    • Haga clic en el botón "Agregar".
    • Seleccione "Francés".
    • Valide la ventana de selección de idiomas.
  4. Valide la ventana de descripción del análisis.
    Para tener en cuenta todos los idiomas del proyecto relacionados con el análisis actual, haga clic en "Sincronizar con el proyecto".

Información multilingüe compartida

Veamos un ejemplo sencillo de cómo introducir información compartida en varios idiomas: vamos a definir el título del control enlazado al campo "Address" del archivo de datos "Customer":
  1. Seleccione el archivo de datos Customer.
  2. Abra la descripción de los campos (seleccione "Descripción de los campos" en el menú contextual del archivo de datos).
  3. Seleccione el campo "Address" y abra los parámetros del control enlazado al campo seleccionado (información compartida). Para ello, haga clic en el enlace en la parte inferior de la pantalla. La información compartida se muestra en una nueva ventana.
  4. En la pestaña "General", en el título francés, introduzca "Adresse".
  5. Valide la ventana de información compartida.
  6. Valide la ventana de descripción de los campos.
    La información compartida del análisis se puede traducir:
    • al crear el análisis.
    • en cualquier momento a través del editor.
    • en cualquier momento a través de WDMSG y WDTRAD, herramientas utilizadas para extraer, traducir y reintegrar los diferentes elementos del proyecto. Estas dos herramientas se presentarán más adelante en este tutorial.

Aplicar los cambios

Para tener en cuenta los cambios, debe generar el análisis: en la pestaña "Análisis", en el grupo "Análisis", haga clic en "Generación".
Cierre el editor de análisis (haga clic en la "X" del análisis en las pestañas de documentos abiertos).
Etapa 3: Adaptar los diferentes elementos del proyecto a varios idiomas
Todos los elementos del proyecto pueden ser multilingües: ventanas, reportes, ayuda, etc. Cada uno de estos elementos puede contener diferentes objetos a traducir: controles, imágenes, menús, código, etc. Dependiendo del objeto a traducir, se puede utilizar un método específico.
Para utilizar varios idiomas en nuestra aplicación, modificaremos algunos elementos de la ventana WIN_Menu:
  • la imagen de la barra de la ventana WIN_Menu.
  • el texto de los controles de la ventana WIN_Menu.
  • las opciones de menú.
  • el mensaje que muestra el código WLanguage al cerrar la aplicación.
Primero, compruebe si la ventana WIN_Menu está asociada a los diferentes idiomas definidos en el proyecto:
  1. Abra la ventana "WIN_Menu" en el editor (haga doble clic en ella en el panel "Explorador de proyectos", por ejemplo).
  2. Abra la descripción de la ventana (opción "Descripción" del menú contextual).
  3. Seleccione la pestaña "Idioma": los dos idiomas seleccionados en el proyecto aparecen.
  4. Confirme los cambios y cierre la ventana de descripción.

Utilizar una imagen multilingüe

En una aplicación, puede ser necesario utilizar diferentes imágenes en función del idioma.
En nuestro ejemplo, la imagen del banner de la ventana WIN_Menu contiene el nombre de la aplicación. Como este nombre es diferente en cada idioma, tenemos que cambiar la imagen.
Esta imagen se utiliza en el modelo de ventanas, por lo que debe modificarse en el modelo. Esta modificación puede aplicarse a todas las ventanas que utilicen el modelo. Para obtener más información, consulte Modelos de ventanas.
Para cambiar la imagen de la barra de la ventana WIN_Menu según el idioma de ejecución:
  1. Abra la ventana "WIN_Menu".
  2. La imagen de la barra se encuentra en el modelo asociado a la ventana. Por lo tanto, es necesario abrir el modelo de ventanas asociado:
    • Haga clic en el control "WD FullApplication" y abra el menú contextual.
    • Seleccione la opción "Abrir modelo".
    • El modelo de ventanas se abre con un marco naranja.
  3. Abra la ventana de descripción del banner:
    • Seleccione el control "WD FullApplication" y abra el menú contextual.
    • Seleccione "Descripción".
  4. En la sección "Imagen", haga clic en .
  5. En el menú contextual que aparece, seleccione "Multilingüe".
  6. La ventana de gestión de imágenes multilingües se abre. Se puede utilizar una imagen diferente para cada idioma. Esta opción es especialmente útil cuando las imágenes contienen texto.
  7. Para nuestro ejemplo, en el área "Francés", seleccione el archivo "header-fr.png":
    • Haga clic en .
    • Seleccione "Examinar".
    • Seleccione el archivo deseado.
  8. Valide. El texto "<Valor multilingüe>" aparece en el campo "Imagen" de la ventana de descripción.
  9. Valide la ventana de descripción del control.
  10. Guarde el modelo de ventanas ( o Ctrl + S).
  11. Actualice las ventanas que utilizan el modelo de ventanas haciendo clic en el ícono en la barra naranja. Valide la ventana de actualización.
  12. Cierre el modelo de ventanas que se muestra en el editor.

Traducir controles

Un control puede mostrar diferente información al usuario:
  • un título,
  • un mensaje de ayuda,
  • una imagen, etc.
Algunas veces es necesario traducir esta información. Puede acceder a ella en las diferentes pestañas de la ventana de descripción del control.
Para nuestro ejemplo, traduciremos la primera pestaña del control Pestaña en WIN_Menu.
  1. Haga doble clic en el control Pestaña para abrir la ventana de descripción.
  2. En la pestaña "General" de la ventana de descripción, seleccione "List of products".
  3. En la sección "Descripción de una pestaña estática", realice las siguientes acciones:
    • introduzca la traducción del texto de la pestaña: "Liste des produits".
    • defina una imagen específica para la pestaña por cada idioma (como se hizo anteriormente).
    • defina un tooltip (globo de ayuda) para cada idioma.
  4. Cierre la ventana de descripción del control.

Traducir textos de programación

El texto que muestra el código WLanguage de la aplicación también puede traducirse a varios idiomas. En nuestro ejemplo, al hacer clic en la opción de menú "Exit", aparece el cuadro de diálogo "Exit application?". Vamos a traducir este mensaje.
Para traducir el texto de la opción de menú:
  1. Abra el código de la opción de menú:
    • Despliegue el menú en el editor.
    • Seleccione la opción "Exit".
    • Haga clic derecho para abrir el menú contextual y seleccione "Código".
      En esta sección de código, el texto a traducir es "Exit application?".
  2. Ubique el cursor en la cadena "Exit application?".
  3. Presione Ctrl + T. La siguiente ventana se abre:
    Esta ventana permite traducir el texto de la aplicación a todos los idiomas del proyecto.
  4. En la sección "Francés", escriba "Quitter l'application?" y valide.
En el editor de código, el ícono aparece junto a la cadena.
Este ícono indica que el mensaje está en varios idiomas. Puede ver rápidamente las traducciones pasando el cursor por encima del ícono.
Estas son todas las acciones que necesitamos hacer en el código. Cierre el editor de código.

Traducir menús y opciones de menú

Una opción de menú puede traducirse como cualquier otro control a través de su ventana de descripción, o directamente desde el editor de ventanas. En nuestro ejemplo utilizaremos este último método.
Para traducir el menú de la ventana "WIN_Menu":
  1. En la pestaña "Vista", en el grupo "Opciones", despliegue "Idioma mostrado" y seleccione el idioma que desea que se muestre en el editor (Francés en este caso).
    Las opciones de menú se muestran en el idioma seleccionado. Si ninguna traducción corresponde al idioma seleccionado, las opciones de menú se muestran en inglés.
  2. Despliegue la opción "Menu".
  3. Seleccione "Send an email".
  4. Pulse la barra espaciadora: el texto pasa a modo de edición.
  5. Introduzca el siguiente texto en francés: "Envoyer un email" y valide.
  6. Vuelva a cambiar el idioma a inglés: en la pestaña "Vista", en el grupo "Opciones", despliegue "Idioma mostrado" y seleccione "Inglés".
Etapa 4: Cambiar el idioma mediante programación
Hemos traducido diferentes elementos de la ventana WIN_Menu. Ahora veamos cómo cambiar el idioma de la aplicación.
De forma predeterminada, la aplicación se ejecuta en el idioma definido para el proyecto. Este idioma puede definirse en la pestaña "Idiomas" de la descripción del proyecto (opción "Descripción" de la pestaña "Proyecto").
En una aplicación, existen varios métodos para seleccionar el idioma que se va a utilizar. En la mayoría de los casos, se utiliza una opción de menú (o un botón "Idioma"). Puede utilizar la función Nation para cambiar el idioma de la aplicación en ejecución.
Para nuestro ejemplo, vamos a agregar una opción de menú para seleccionar el idioma deseado.

Agregar una opción de menú

Para agregar una opción de menú:
  1. Abra la ventana "WIN_Menu" en el editor si es necesario (haga doble clic en ella en el panel "Explorador de proyectos").
  2. Haga clic en la opción "Menu" de la ventana. El menú se despliega.
  3. Seleccione "Send an email".
  4. Haga clic derecho para abrir el menú contextual. Seleccione "Agregar una opción después". Introduzca el texto "Languages" y valide.
  5. Seleccione la opción "Languages" que acaba de crear.
  6. Haga clic derecho para abrir el menú contextual y seleccione la opción "Transformar para expandir un submenú".
  7. Introduzca el texto de la primera subopción: "English".
  8. Presione dos veces la tecla "Entrar" e introduzca el texto de la segunda opción ("French").
Vamos a escribir el código WLanguage para cambiar el idioma.

Programación

Para introducir el código de gestión de los idiomas:
  1. Seleccione la opción "Menu .. Languages .. French" en el editor.
  2. Haga clic derecho para abrir el menú contextual. Seleccione "Código".
  3. Introduzca el siguiente código:
    Nation(nationEnglish)
  4. Guarde los cambios y cierre el editor de código.
  5. Seleccione la opción "Menu .. Languages .. English" en el editor.
  6. Haga clic derecho para abrir el menú contextual. Seleccione "Código".
  7. Introduzca el siguiente código:
    Nation(nationFrench)
    La función Nation cambia el idioma de ejecución de la aplicación. Las constantes pasadas como parámetros especifican el idioma que se va a utilizar.
    La función Nation cambia el idioma inmediatamente.
  8. Guarde los cambios y cierre el editor de código.
Prueba de un proyecto multilingüe
Hemos traducido algunos elementos de la aplicación. Ahora, vamos a cambiar el idioma en modo de prueba.
Para probar la aplicación:
  1. Pruebe el proyecto (haga clic en en los botones de acceso rápido). La ventana se muestra en modo de prueba en inglés.
  2. Seleccione la opción "Menu .. Languages .. French".
  3. Los elementos que modificamos en la aplicación se muestran en francés:
    • la imagen del modelo de ventana.
    • la primera pestaña.
  4. Finalice la prueba seleccionando "Menu .. Exit". El mensaje aparece en francés.
  5. Valide y vuelva al editor.
Información adicional: Herramientas de traducción
Hemos traducido manualmente algunos elementos de la aplicación.
Sin embargo, WINDEV ofrece varios métodos de traducción:
  • traducir los mensajes directamente en los editores. Esta traducción se puede realizar utilizando una herramienta de traducción, como Google Traductor (si tiene una licencia), etc.
  • traducir los mensajes con una herramienta externa (WDMSG y WDTRAD).

Introducir las traducciones directamente

Las traducciones se pueden introducir directamente en la interfaz. Por ejemplo, el texto del botón "New" se puede traducir por "Nouveau" en francés. Para ello, abra la ventana de descripción del control e introduzca la traducción correspondiente.
Si desea utilizar un software o un sitio de traducción, WINDEV se puede configurar para utilizar el sistema de traducción deseado:
  1. En la pestaña "Inicio", en el grupo "Entorno", despliegue "Opciones" y seleccione "Opciones generales de WINDEV".
  2. Vaya a la pestaña "Traducción".
  3. Especifique:
    • Si los parámetros regionales deben activarse automáticamente según el idioma de entrada. En este caso, si el idioma requiere un conjunto de caracteres específico, este se seleccionará automáticamente.
    • El software o sitio de traducción que se va a utilizar. Puede utilizar WDDIXIO, un diccionario de traducción incluido en WDMSG (véase el párrafo siguiente), un software o sitio de traducción específico, o Google Traductor.
      Para obtener más información, consulte Traducción con Google Traductor.
    • Los idiomas del proyecto (por ejemplo, "inglés" como idioma de origen y "francés" como idioma de destino).
  4. Valide.
  5. Una vez definidos los ajustes de traducción, puede utilizar el botón en las diferentes ventanas de descripción de los elementos del proyecto: este botón le permite utilizar el programa de traducción.

Traducción con WDMSG y WDTRAD

Puede usar WDMSG, una herramienta (no proporcionada con WINDEV) que permite:
  • extraer todos los mensajes del proyecto (títulos de controles, mensaje de código, títulos de ventanas, etc.) para traducirlos,
  • reintegrar los mensajes traducidos.
Los mensajes a traducir se extraen:
  • en un formato de texto que se puede configurar para utilizarse con diferentes herramientas de traducción.
  • en formato HFSQL.
WDMSG también incluye WDTRAD, una herramienta de traducción asistida. WDTRAD permite introducir fácilmente todas las traducciones de los recursos multilingües de un proyecto.
Póngase en contacto con el Departamento de ventas de PC SOFT para obtener más información sobre WDMSG y WDTRAD.

Otros elementos a traducir: mensajes del framework

El framework de WINDEV contiene varios mensajes. Por ejemplo, los días y meses utilizados por las funciones de fechas provienen del framework de WINDEV. Para traducir una o más bibliotecas del framework, utilice WDINT (no incluido con WINDEV).
Este programa permite obtener un archivo WDM. Para usar este archivo en la aplicación:
  • utilice la función LoadError.
  • agregue el archivo en la pestaña "Idiomas" de la descripción del proyecto. Seleccione el idioma deseado, y luego vaya a la pestaña "Varios".
Póngase en contacto con el Departamento de ventas de PC SOFT para obtener más información sobre WDINT.
Tabla de contenido
Versión mínima requerida
  • Versión 2024
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 15/12/2023

Señalar un error o enviar una sugerencia | Ayuda local