Dialog Support for Right-to-Left Languages

InstallShield 2020

Edition:The Premier edition of InstallShield includes dialog support for languages such as Arabic and Hebrew, which are read from right to left.

Project:The following project types include dialog support for right-to-left languages:

Basic MSI
Merge Module

InstallShield includes support for Arabic (Saudi Arabia) and Hebrew languages, which are written and read from right to left. All of the default end-user dialog strings are available in these languages.

Since these languages are read from right to left, InstallShield also includes support for mirroring Arabic and Hebrew dialogs; that is, InstallShield uses a right-to-left layout for Arabic and Hebrew dialogs. Thus, for example, buttons that are on the right side of dialogs in English and other left-to-right languages are moved to the left side of right-to-left-language dialogs. This occurs in the Dialog Editor pane in the Dialogs view of InstallShield; it also occurs at run time.

Reversed versions of the dialog images are displayed for the built-in dialog themes if appropriate. The reversed versions have _mirror in the image file name immediately before the .bmp or .jpg portion of the file name. For example, the name of an image for left-to-right languages might be banner.jpg; the name of the right-to-left equivalent for that image would be banner_mirror.jpg. These two files would be located in the same folder, and InstallShield would automatically use the banner_mirror.jpg file for the right-to-left-language versions of the dialogs. If an image should not be reversed, a *_mirror.jpg or *_mirror.bmp version of the image is not included, and the right-to-left versions of the dialogs do not show mirrored versions of the images.

Tip:If you use custom images for your run-time dialogs and your project includes support for right-to-left languages, you may need to create mirror-image versions for those right-to-left languages. You can preview the right-to-left layout of the dialogs in the Dialogs view to see how your custom images look. Add *_mirror.jpg or *_mirror.bmp versions of your images to the folder that contains the left-to-right versions of your custom images if appropriate.

See Also