Help / Developing an application or website / Component / External component
  • Overview
  • How to?
  • Translating a component used in an application
  • Translating and updating the component
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WindowsLinuxPHPWEBDEV - Browser code
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Stored procedures
Translating the external components
In WINDEV, WEBDEV or WINDEV Mobile, an external component is a set of elements that performs a specific action (send faxes, emails, etc.). External components can be redistributed to other WINDEV, WEBDEV or WINDEV Mobile developers.
Developers will then be able to easily include the feature from the component in their applications. The component will be included in and distributed with the application.
For multilingual applications, it may be useful to translate the external component used. Indeed, let's imagine a component that supports French and English included in a project that supports French and Spanish.
By default, the mechanism for preferred languages proposes English instead of Spanish.
In order for the external component to use the application language, the different elements of the components must be translated. This technique requires the use of WDMSG. WDMSG is an optional tool for WINDEV, WEBDEV and WINDEV Mobile used to extract and reintegrate all the messages to be translated.
How to?

Translating a component used in an application

To translate a component used in an application:
  1. Install (if necessary) WDMSG on the development computer.
  2. The component used by the project must be defined as translatable: the translation of the component must have been allowed by the author of the component.
    To do so, check "Allow component translation" when generating the component. For more details, see Generating a component.
    To find out whether the components used can be translated, open the description of the component ("General" tab).
  3. Use WDMSG to extract the elements from the component (and from your project if necessary): on the "Translate" tab, in the "Project" group, expand "Translate" and select "Extract messages". A wdmsg file containing the messages to translate is created.
  4. Translate the messages (or contact a translator). For more details on WDMSG, see Using WDMSG.
  5. Reintegrate the translated messages: on the "Translate" tab, in the "Project" group, expand "Translate" and select "Reintegrate messages". Several files are automatically created during the reintegration:
    • <Component name>.WDIT: This file contains the different messages of the component in the source language as well as their translation. This file is found on the development computer only.
    • <Component name>.WDKT: This file contains the different translations of the component in the desired language. This file will be used at runtime to display the translated messages in the desired language.
  6. The application can be deployed.

Translating and updating the component

The version of the component changes when the component is updated in the project.
When updating the component, the WDKT file is automatically re-created from the existing translations found in the WDIT file. Indeed, the version of the component must be synchronized with the version of the WDKT file. To do so, WDMSG must be installed on the computer.
The component is ready to be used.
  • If all the resources of the component have been translated, the elements of the component will be displayed in the desired language.
  • If some resources have not been translated, they will appear in the original language of the component. In this case, it will be necessary to perform another extraction with WDMSG to translate the missing resources.
Minimum version required
  • Version 12
This page is also available for…
Click [Add] to post a comment

Last update: 08/31/2022

Send a report | Local help