Multilingual User Interface (MUI) Registry Settings (Windows CE 5.0)
The following table shows the registry settings for the HKEY_CURRENT_USER\MUI registry key.
| Value : type | Description |
|---|---|
| Curlang : REG_DWORD | Specifies the language identifier (LCID) for the current user. |
The following table shows the registry settings for the [HKEY_LOCAL_MACHINE\MUI registry key.
| Value : type | Description |
|---|---|
| Enable : REG_DWORD | Default set to 1. Setting this value to 1 enables MUI on the run-time image; setting this value to 0 disables MUI on the run-time image. |
| Syslang : REG_DWORD | No default is set. Specifies the system default language identifier (LCID). |
MUI Registry
Windows CE .NET 4.2 and later supports the MUI registry. The MUI registry enables you to store localizable strings that were traditionally stored in the registry, in the resource section of the applicable module, such as a .dll or an .exe file. This mechanism extends the functionality of the MUI Catalog item. The MUI registry enables you to have one registry entry that points to several localized strings with the active value being based on the current locale settings.
To create a registry entry for a localizable string
Using Notepad, open the .reg file where the registry settings for the applicable module are stored.
Create a registry entry of type REG_MUI_SZ for each string. Each registry entry must list the module containing the localized content, and the resource ID of the string. Use the following syntax:
"ValueName"=mui_sz:"<dll name>, #<resource id>"For example, to create a registry entry for the localized version of the string "Folder", add the following registry entry to the .reg file:
"Folder"=mui_sz:"MySample.dll,#20"
Setting the value to MySample.dll,#20 implies that the localized version of the string is stored as resource #20 in the MySample.dll module.
To retrieve the value of a localized string from the registry, an application must call the RegQueryValueEx or RegEnumValue functions. The registry will automatically locate the appropriate MUI module, load the string, and return it to the application. The registry type will be set to REG_SZ on return of the function call.
To overwrite an existing registry value, an application must call the RegSetValueEx function. Overwriting the REG_MUI_SZ value with a value of type REG_SZ will replace the MUI registry value with the specified constant registry value. This new value will be applied to all locale settings.
To read the formatted MUI specification string that has been specified in the registry, an application should preset the value type to REG_MUI_SZ before calling RegQueryValueEx. To change the MUI specification, an application can also set the value type to REG_MUI_SZ when it calls RegSetValueEx. You must format the registry value using the appropriate syntax described in Step 2.
Note The MUI registry method may not apply to certain localizable string elements, such as desktop shortcuts and driver names.
See Also
Multilingual User Interface (MUI)
Send Feedback on this topic to the authors