SftPrintPreview/OCX 1.0 - ActiveX Print Preview Control

National Language Support

SftPrintPreview/OCX is provided with built-in support for US English only.

Using resource-only DLLs, the product can be translated into any language supported by Windows. These resource-only DLLs are not included, but can be easily created using the product's included sample Resource project. The dialogs and strings defined by these DLLs can be edited using Visual C++/Visual Studio .NET and translated. Translating the resources into a new language takes about 30 minutes.

When a SftPrintPreview/OCX control is created, it inspects the current user's default language selection (see Windows API GetUserDefaultLangID) and attempts to load resource-only DLLs in the following order:

SftPrintPreview10Resources_primary_sub.dll SftPrintPreview10Resources_primary_01.dll SftPrintPreview10Resources_primary_00.dll

The most language specific DLL is loaded first. Whichever DLL is present and found first, will be used to locate all SftPrintPreview/OCX resources, that are language specific. If none of these resource-only DLLs can be found, the control's built-in US English resources are used instead.

primary and sub represent the primary language ID and sublanguage ID as defined by the Windows API GetUserDefaultLangID.

For example, if the user's current default language is LANG_GERMAN / SUBLANG_GERMAN_AUSTRIAN (see tables below), the following DLLs would be loaded in this order:

SftPrintPreview10Resources_07_03.dll SftPrintPreview10Resources_07_01.dll SftPrintPreview10Resources_07_00.dll

Building a Resource-Only DLL

Copy the entire Resources directory, part of the SftPrintPreview/OCX installation, to a location of your choice. This insures that the original sample project in unchanged.

Depending on your target location, you may need to update the Project Settings reflecting the new paths.

Using Visual C++ or Visual Studio .NET, modify all resources found in Resources.rc, translating these to your language of choice. Strings can be extended within reason (for example, if a string is 80 bytes in the provided default US English resource, it can be safely extended to 300 bytes).

Change the Project Settings to produce (link) the final DLL with the proper name, using the following naming conventions:

SftPrintPreview10Resources_primary_sub.dll

primary and sub represent the primary language ID and sublanguage ID as defined by the Windows API GetUserDefaultLangID (see tables below).

Once the DLL has been completed, simply copy it to your application directory. SftPrintPreview/OCX will now use these resources if the language settings for the current user match the DLL's primary and sublanguage ID.

Primary Language ID

Sublanguage ID