Localizing the Get User Input Panels

InstallAnywhere 2018

You can easily internationalize choices in the Get User Input panel by editing a project's locale files. Each choice or option on the Get User Input panel is localizable whether it is a label, text field, option button, or check box. Following are some examples that use English and French.

Get User Input - Simple Panel Example

To localize a Get User Input - Simple panel:

1. Create your project as you normally would. In this example, add a Get User Input - Simple panel that asks the question: “Are you ready?” This panel displays option buttons with Yes and No as possible choices.
2. Build for all intended platforms and locales.
3. Locate your project’s locales directory. This directory is in the same location as your project file, and the directory is named to match your project name:

Project_namelocales_Build_configuration_name

For example:

My_Productlocales_MacOSConfiguration

4. Use a simple text editor (for example, Notepad, TextEdit, VI, or emacs) to open the custom_fr and custom_en files.
5. In the custom_en file, search for the text that you want to customize (the text string used in your Get User Input - Simple panel, in this case—"Are you ready?"). It will look something like this (though the ID may be different):

# CreateDialog.c586fa408eaf.prompt=Are you ready?

CreateDialog.c586fa408eaf.prompt=Are you ready?

# CreateDialog.c586fa408eaf.title=Get User Input

CreateDialog.c586fa408eaf.title=Get User Input

If you want to change the Yes/No, just do a search for Yes or No in the custom_en. You find something like this:

# EntryAtom.c8ca91558eaf.label=Yes

# EntryAtom.c58723868eaf.label=No 

6. Find the matching entries in the custom_fr file.
7. In the custom_fr file, make changes to the matching entries to reflect the customizations for this locale. For example:

# CreateDialog.c586fa408eaf.prompt=Are you ready?

CreateDialog.c586fa408eaf.prompt= Étes-vous prêt?

 

# CreateDialog.c586fa408eaf.title=Get User Input

CreateDialog.c586fa408eaf.title=Obtenez Entrée de L'Utilisateur

 

# CreateDialog.ef23914cb8fd.ValidInputsAsCommaSeparatedString=yes,no

CreateDialog.ef23914cb8fd.ValidInputsAsCommaSeparatedString=oui,non

 

# EntryAtom.c8ca91558eaf.label=Yes

EntryAtom.c8ca91558eaf.label=Oui

 

# EntryAtom.c58723868eaf.label=No

EntryAtom.c58723868eaf.label=Non

 

8. Rebuild your project.

The installer uses the proper entries in the proper locale.

Get User Input - Advanced Example

The process is similar for the Get User Input - Advanced panels. Following is the same example, but using the Get User Input - Advanced panel.

To localize a Get User Input - Advanced panel:

1. Create your project as you normally would. In this example, add a Get User Input - Advanced panel that asks the question: “Are you ready?” This panel displays option buttons with Yes and No as possible choices.
2. Build for all intended platforms and locales.
3. Locate your project’s locales directory. This directory is in the same location as your project file, and the directory is named to match your project name:

Project_namelocales_Build_configuration_name

For example:

My_Productlocales_MacOSConfiguration

4. Use a simple text editor (for example, Notepad, TextEdit, VI, or emacs) to open the custom_fr and custom_en files.
5. In the custom_en file, search for the text that you want to customize (the text string used in your Get User Input - Advanced panel, in this case—"Are you ready?"). It will look something like this (though the ID may be different):

# GetUserInput.c8e4659f8f03.title=Get User Input

GetUserInput.c8e4659f8f03.title=Get User Input

 

# GUIGroupData.c8e471658f03.caption=Are you ready?

GUIGroupData.c8e471658f03.caption=Are you ready?

 

If you want to change the Yes/No, just do a search for Yes or No in the custom_en. You find something like this:

# GUIComponentData.c8e477e48f04.label=Yes

GUIComponentData.c8e477e48f04.label=Yes

 

# GUIComponentData.c8e4c9558f04.label=No

GUIComponentData.c8e4c9558f04.label=No

 

6. Find the matching entries in the custom_fr file.
7. In the custom_fr file, make changes to the matching entries to reflect the customizations for this locale. For example:

# GetUserInput.c8e4659f8f03.title=Get User Input

GetUserInput.c8e4659f8f03.title=Obtenez Entrée de L'Utilisateur

 

# GUIGroupData.c8e471658f03.caption=Are you ready?

GUIGroupData.c8e471658f03.caption= Étes-vous prêt?

 

# GUIComponentData.c8e477e48f04.label=Yes

GUIComponentData.c8e477e48f04.label=Oui

 

# GUIComponentData.c8e4c9558f04.label=No

GUIComponentData.c8e4c9558f04.label=Non

 

8. Rebuild your project.

The installer uses the proper entries in the proper locale.

See Also