.NET Projects

When localizing a .NET project, you have the option of localizing only some *.resx files and leaving the remainder in English. You may also localize all *.resx files.

.NET resource files are included with the ArcFM Solution installation in the following directory: Program Files\Miner and Miner\ArcFM Solution\Resources\. You may use a third-party translater to translate the resource files into another language.

The file names for translated *.resx files must include the CultureCode. For example, a file called Miner.FrameworkUI.Windows.AboutDialog.resx would be renamed to Miner.FrameworkUI.Windows.AboutDialog.es-Mx.resx. when translated to Mexican Spanish.

The ArcFM Solution uses the CultureCode values as assigned by Microsoft. A complete list of these values is available in MSDN. ArcFM Solution uses the Culture Name value.

You may override the current localization setting by modifying the following registry setting: HKEY_CURRENT_USER\Software\WOW6432Node\Miner and Miner\Resources\CultureCode. The CultureCode value is set to the language of your Operating System. If your OS is Mexican Spanish and you're translating your ArcFM Solution application to Mexican Spanish, then this setting does not need to be modified. If you're translating your ArcFM application to a language different from your OS language, this registry key must be set to the CultureCode used when renaming *.resx files.

Regarding CultureCode: You may also set this value in HKEY_CURRENT_USER\Software\WOW6432Node\Miner and Miner\Resources\CultureCode. Resource files look first in the HKEY_CURRENT_USER section of the registry. If the setting doesn't exist there, it looks in the HKEY_LOCAL_MACHINE section. If neither setting exists, it defaults to English.

If you wish to view your ArcFM application in a language other than English, you may localize it into any language using the following instructions.

You can localize strings and/or forms. The first section below discusses localizing strings, while the second section discusses localizing forms. The final section discusses the steps to be performed after localizing any .resx files (strings or forms).

Localize Strings

You will need to modify the .resx files installed with ArcFM. They are installed at the following location: Program Files\Miner and Miner\ArcFM Solution\Resources.
Look for any files that contain MinerResources.resx or Properties.Resources.resx. These files contain strings; all others contain forms. Open each .resx file using an application that allows you to view and edit XML. Modify the strings as needed.
Save the .resx files, but DO NOT move them from the directory in which they reside.
Follow the steps in the Finish Localization section below.

Localize Forms

You can localize forms using the same method as strings (see Localize Strings section above), or you can use the WinRes.exe provided with the .NET 2.0 Framework. The instructions below discuss how to use WinRes.exe.

If you choose to use WinRes.exe, you will need an Infragistics license in order to view the fields on the forms. Without an Infragistics license, WinRes.exe will use a placeholder instead of displaying the component. Not all ArcFM forms use Infragistics components.

The Windows Resource Localization Editor (WinRes.exe) allows you to localize forms. This product is included with the .NET 2.0 Framework. You may also choose to use another third-party tool to localize .resx files. WinRes.exe is installed here: Program Files\Microsoft Visual Studio 8\SDK\v2.0\Bin
Note: The Windows Resource Localization Editor localizes forms only. It will not localize global strings (see Localize Strings section above).
In order to use the Windows Resource Localization Editor, it must reside in the same directory as the .resx files. Copy WinRes.exe to the directory that holds the .resx files: Program Files\Miner and Miner\ArcFM Solution\Resources.
Open each .resx file using WinRes.exe and modify the forms as necessary. See the Windows Resource Localization Editor for more information about this tool. If you do not have an Infragistics license, the Infragistics components will be replaced with a place holder.
Save the .resx files, but DO NOT move them from the directory in which they reside.
Follow the steps in the Finish Localization section below.

Finish Localization

Follow these steps for ALL localized resource files (strings and forms).

Once you have modified the strings and/or forms, you will need to include the CultureCode in the name of the .NET resource files (*.resx). They are installed here: Program Files\Miner and Miner\ArcFM Solution\Resources. DO NOT move these files.
Change the name of the resource files to include the CultureCode that corresponds to your language. For example, Miner.Desktop.StoredStuffTreeView.resx would be renamed to Miner.Desktop.StoredStuffTreeView.es-Mx.resx
This step is optional. You may override the current localization setting by modifying the following registry setting: HKEY_CURRENT_USER\Software\WOW6432Node\Miner and Miner\Resources\CultureCode. The CultureCode value is set to the language of your Operating System. If your OS is Mexican Spanish and you're translating your ArcFM Solution application to Mexican Spanish, then this setting does not need to be modified. If you're translating your ArcFM application to a language different from your OS language, this registry key must be set to the CultureCode used when renaming *.resx files.