How to Install Components Based on Language

Title

Summary

How to specify which language-based components are installed at runtime

Synopsis

A language-dependent component can be configured to install only on certain languages. The method to configure this behavior will depend on the project type used.

Discussion

Basic MSI and InstallScript MSI Projects
To specify whether a component is installed based on the target system?s language, use the Windows Installer property SystemLanguageID in the component?s Condition setting.

For example, the following condition allows the component?which may or may not be marked as French in InstallShield?to be installed only onto French (France) systems:

SystemLanguageID = 1036

Other properties that can be used to determine language characteristics at run time are UserLanguageID, which is the numeric identifier of the end user?s default language, and ProductLanguage, which is the identifier of the language in which the installation is running.

Refer to the following article for The Language IDs for Various Languages.

InstallScript Projects
During run time of InstallScript installations, you can control the languages that your installation supports by calling the FeatureFilterLanguage function.

In the OnFilterComponents event handler, the framework typically calls this function with the languages that match the target system so that only the appropriate components are installed. By calling FeatureFilterLanguage, you can override this default behavior to install or prevent the installation of components based on any language criteria that you specify.

The FeatureFilterLanguage function filters (excludes) files from file transfer based on language. By default, all languages included in the media build are unfiltered (included). You must call FeatureFilterLanguage for each language you wish to filter or unfilter.

To filter language-specific components during the installation:

Filter (exclude) all languages by calling FeatureFilterLanguage with ISLANG_ALL in the parameter nLangID and bFiltered set to TRUE.
For each language that you want to install, call FeatureFilterLanguage with the appropriate language constant in nLangID and with the parameter bFiltered parameter set to FALSE. Each call unfilters (includes) components for the language specified in nLangID.

Note: You cannot specify multiple language constants in the nLangID parameter by using the OR operator ( | ). Specifying multiple language constants causes the function to perform incorrectly.

Refer to the Additional Information section below for more details on FeatureFilterLanguage.

Additional Information

Marking Components as Language Dependent
Language Identifiers
Language Support for InstallScript
FeatureFilterLanguage Reference
FeatureFilterLanguage Example

Was this helpful?

Support Hub

Product

InstallShield

Visibility

Guest

URL Name

how-to-install-components-based-on-language

Are you sure you want to cancel the case creation?

Case closed successfully

Action performed successfully

Upload Attachment

Maximum file size allowed is 3 MB.

File type not supported.

Supported file types:

Documents (.txt, .doc, .docx, .pdf), Images (.jpg, .png), Comma Separated Files (.csv) Speadsheets (.xlsx, .xls)

Are you sure you want to close this case

Get Hotline support

Products	Region	Phone Numbers
FlexNet Operations FlexNet Embedded FlexNet Publisher FlexNet Connect FlexNet Code Insight InstallAnywhere InstallShield	North America *	+1 630-332-2513 (toll) +1 877-279-2853 (toll-free in North America)
	Europe *	+44 1925 944367 (toll) +44 800 047 8642 (toll-free in Europe)
	Japan *	+81 3-4540-5335 (select option 2)
	Australia *	+61 3 9895 2177 +61 1800 560 603 (toll-free in Australia)
Usage Intelligence (formerly Revulytics) Compliance Intelligence	Please use the Case Portal to submit your support ticket or reach out to your Revenera contact.

Summary

Synopsis

Discussion

Additional Information

Related Articles

Please wait...

Case id: 00001065