SftBox/OCX 4.5

Upgrading To Version 4.5

Softel vdm, Inc.

Converting an Existing Application

The conversion is not automatic.

Only a minimal conversion is required when upgrading from SftBox/OCX 4.0 to SftBox/OCX 4.5. SftBox/OCX 4.5 is completely source compatible with older releases of SftBox/OCX. Your application(s) must be recompiled to use SftBox/OCX 4.5.

SftBox/OCX 4.5 and older versions of SftBox/OCX and SftBox/ATL can coexist on the same system and can be used in the same application.

Make sure to back up your current projects, before converting your projects.  Please read the conversion process specific to your language carefully BEFORE converting your project.
After converting, once the control saves updated property settings, you will not be able to return to SftBox/OCX 4.0.

Visual Basic
.NET (Managed Languages)
Visual C++ (Unmanaged C/C++)
Delphi
HTML
Other Development Tools

Visual Basic

After installing SftBox/OCX 4.5, all your projects will continue to use SftBox/OCX 4.0 until you make the following change in each project's main VBP (Visual Basic Project) file. Before opening the project file, make sure to close the project in Visual Basic, then edit the VBP file using a text editor and make the following changes:

Existing Project File (VPB File):

Type=Exe
Form=Form1.frm
Reference=*\G{00020430-0000-0000-C000-000000000046}#2.0#0#G:\WINNT\System32\stdole2.tlb#OLE Automation
Object={9DBBC74B-4467-4CAF-8C49-0B1AB1434734}#4.0#0; SftBox_IX86_U_40.ocx
IconForm="Form1"
Startup="Form1"
ExeName32="yourexe.exe"
Command32=""
Name="yourproject"

The line describing SftBox/OCX 4.0 (above, using a bold font) should be replaced with the following:

Type=Exe
Form=Form1.frm
Reference=*\G{00020430-0000-0000-C000-000000000046}#2.0#0#G:\WINNT\System32\stdole2.tlb#OLE Automation
Object={AD9B5C4B-4F77-4325-9EEB-F7E2B0583BCE}#4.5#0; SftBox_IX86_U_45.ocx
IconForm="Form1"
Startup="Form1"
ExeName32="yourexe.exe"
Command32=""
Name="yourproject"

You can copy this line directly from this help file or copy it from the file "Upgrade.txt" which you can find in the SftBox/OCX product directory. The line must be copied as-is, without any modifications.

Existing Forms And Modules (FRM, BAS Files):

All forms and modules must be edited using a text editor.  The following changes can easily be accomplished by a global edit and replace operation:

All occurrences of "SftBoxLib40." must be replaced by "SftBoxLib45." (make sure to enter the trailing period for both strings).

Once the VBP file has been saved, you can open the project in Visual Basic and the project is now using SftBox/OCX 4.5. The controls will save updated property settings, so you will not be able to return to SftBox/OCX 4.0.

.NET (Managed Languages)

While most other languages offer a fairly easy conversion, .NET and its languages require a bit more effort, but in most cases is limited to the steps documented below.

Existing Forms (FRM Files):

Updating the forms to use SftBox/OCX 4.5 is quite straightforward:

The forms can now be opened and the project uses SftBox/OCX 4.5 exclusively.  You will not be able to return to SftBox/OCX 4.0.

Visual C++ (Unmanaged C/C++)

Resource Files

After installing SftBox/OCX 4.5, all your projects will continue to use SftBox/OCX 4.0 until you make the following change in each dialog resource that defines a SftBox/OCX control. Before opening the resource script (RC file), make sure to close the project in Visual C++, then edit the RC file using a text editor and make the following changes:

IDD_MFC_DIALOG DIALOGEX 0, 0, 320, 200
STYLE DS_MODALFRAME | WS_POPUP | WS_VISIBLE | WS_CAPTION | WS_SYSMENU
EXSTYLE WS_EX_APPWINDOW
CAPTION "MFC"
FONT 8, "MS Sans Serif"
BEGIN
    DEFPUSHBUTTON   "OK",IDOK,260,7,50,14
    PUSHBUTTON      "Cancel",IDCANCEL,260,23,50,14
    CONTROL         "",IDC_SFTBOX1,"{9DBBC74A-4467-4CAF-8C49-0B1AB1434734}",
                      WS_TABSTOP,7,41,123,12
END

The contents of the line describing SftBox/OCX 4.0 (above, using a bold font) should be replaced with the following line:

    CONTROL         "", IDC_SFTBOX1, "{AD9B5C4A-4F77-4325-9EEB-F7E2B0583BCE}",

Only change the ClassID (i.e., {9DBBC74A-4467-4CAF-8C49-0B1AB1434734} to {AD9B5C4A-4F77-4325-9EEB-F7E2B0583BCE}), do not change the rest of the line.

You can copy this information directly from this help file or copy it from the file "Upgrade.txt" which you can find in the SftBox/OCX product directory. The ClassID must be copied as-is, without any modifications.

Make sure to change ALL occurrences of SftBox/OCX to version 4.5, otherwise you will not be able to open the resource script (RC file).

Once the RC file has been saved, you can open the project in Visual C++ and the project is now using SftBox/OCX 4.5. The controls will save updated property settings, so you will not be able to return to SftBox/OCX 4.0.

#import Statements

Any #import statements that are used in your application must now use the new control:

#pragma warning(disable : 4192) // automatically excluding 'Ixxx' while importing type library
#import <SftBox_IX86_U_40.OCX> rename_namespace("SftBoxNameSpace") // SftBox/OCX Combo Box Control
#pragma warning(default : 4192)

using namespace SftBoxNameSpace;

should be replaced with:

#pragma warning(disable : 4192) // automatically excluding 'Ixxx' while importing type library 'stdole2.tlb'
// For information about the following construct, please see Microsoft's
// KnowledgeBase entry Q224610
#import <SftBox_IX86_U_45.OCX> rename_namespace("SftBoxNameSpace") rename("LoadImage", "LoadImageSftBox") 
#if _MSC_VER >= 1400 // need at least Visual Studio 2005
# pragma comment(lib, "comsuppw.lib") // avoid link error in VS2005
#endif
#pragma warning(default : 4192)

using namespace SftBoxNameSpace;

Delphi

Once SftBox/OCX 4.5 has been installed and added to the Component Palette as described in Using SftBox/OCX with Delphi, all projects have access to SftBox/OCX 4.5.

If the same class (TSftBox) was used to add SftBox/OCX 4.5 to the Component Palette, all projects will automatically use the new version. Otherwise, you will have to manually change each project to use the new defined class name instead of TSftBox.

HTML

After installing SftBox/OCX 4.5, all your HTML pages will continue to use SftBox/OCX 4.0 until you make the following change in each page that uses a SftBox/OCX control.

<OBJECT ID="Combo1" WIDTH=708 HEIGHT=203
 CLASSID="CLSID:9DBBC772-4467-4caf-8C49-0B1AB1434734" CODEBASE="SftBox_IX86_I_40.cab#version=4,0,0,0">
    <PARAM NAME="PropVer" VALUE="40">
    <PARAM NAME="_Version" VALUE="262144">
    <PARAM NAME="_ExtentX" VALUE="14993">

The contents of the line describing SftBox/OCX 4.0 (above, using a bold font) should be replaced with the following:

 CLASSID="CLSID:AD9B5C72-4F77-4325-9EEB-F7E2B0583BCE" CODEBASE="SftBox_IX86_I_45.cab#version=4,5,0,0">

The CODEBASE argument also needs to be updated to reflect the new cabinet name and the current version number.

You can copy this information directly from this help file or copy it from the file "Upgrade.txt" which you can find in the SftBox/OCX product directory. The ClassID must be copied as-is, without any modifications.

Once the page has been saved, you can open the web page using your preferred HTML editor.  The controls will save updated property settings, so you will not be able to return to SftBox/OCX 4.5.

Other Development Tools

Most development tools allow access to the ClassID used for controls on a form or dialog. Sometimes this may be accomplished by using a text editor and editing a configuration file, or possibly the development tool allows direct modification of the ClassID.

Generally, the ClassID used for the prior release {9DBBC74B-4467-4CAF-8C49-0B1AB1434734} must be replaced with the new ClassID {AD9B5C4B-4F77-4325-9EEB-F7E2B0583BCE}. Once this step is completed, opening the project is sufficient to allow SftBox/OCX to convert the stored property settings.

For specific instructions or help, please see your development tool's documentation.

Feedback / comments / error reports for this topic
© 2008 - Softel vdm, Inc. - www.softelvdm.com