Upgrading to Version 2.0
Only a minimal conversion is required when upgrading from an earlier version of SftPrintPreview/DLL to SftPrintPreview/DLL 2.0. SftPrintPreview/DLL 2.0 is virtually 100% source compatible with SftPrintPreview/DLL 1.0. Your application(s) must be recompiled to use SftPrintPreview/DLL 2.0.
SftPrintPreview/DLL 2.0 and an older version of SftPrintPreview/DLL can coexist in the same application to make the conversion as easy as possible, however, they cannot be used in the same source code file.
Upgrading to Version 2.0
The upgrade effort is very minimal. Some structures used in earlier releases of SftPrintPreview have been increased in size, resulting in the requirement to recompile your source code. To allow for SftPrintPreview/DLL 1.0 and this new version to coexist when used by multiple applications, the DLLs have been renamed and a new window class is used.
SftPrintPreview/DLL 2.0 is source code compatible with older releases of SftPrintPreview/DLL, provided the following changes are made in existing applications:
Converting an Existing Application
The conversion effort to implement SftPrintPreview/DLL 2.0 in an application that currently uses version 1.0 is minimal. Most applications will only have to change the window class name used in DIALOG resources (see below).
1. Window Class Change
In SftPrintPreview/DLL 1.0 (the release prior to SftPrintPreview/DLL 2.0), the window class used for SftPrintPreview was SftPrintPreviewControl10. This window class has been dropped and has been renamed to SftPrintPreviewControl20.
Any DIALOG resources that use the old window classes must be changed to use SftPrintPreviewControl20. Without this change, the dialogs will not be displayed.
If the window class name was "hard-coded" in calls to Create or CreateWindow(Ex), the class name must also be changed. The preferred method is to use the preprocessor symbol SFTPRINTPREVIEW_CLASS.
2. Dll And Lib Files Name Change
The Dlls and Lib files have been renamed for this new release. For the new file names, please see the section "Building Applications".
3. SFTPRINTPREVIEW_CONTROL, New Members, Initialization
The SFTPRINTPREVIEW_CONTROL structure size has changed due numerous new members. As long as your application uses the suggested GetControlInfo/SetControlInfo mechanism to retrieve the current settings before updating the structure, no source code changes are necessary.
4. SFTPRINTPREVIEW_COLORS, New Members, Initialization
The SFTPRINTPREVIEW_COLORS structure size has changed due numerous new members. As long as your application uses the suggested GetCtlColors/SetCtlColors mechanism to retrieve the current settings before updating the structure, no source code changes are necessary.
5. National Language Support
The resource DLLs for national language support have additional resources that must be translated, if used.
Dll And Lib Files Name Change
The Dlls and Lib files have been renamed for this new release. For the new file names, please see the section "Building Applications".
When linking statically, the library Gdiplus.lib must be added to the linker project settings (see the section "Building Applications").
On
Off