Upgrading a C++ Builder 3.0 Application to Use LEADTOOLS 16

These instructions describe how to upgrade a C++ Builder 3.0 application from LEADTOOLS 12.1 to LEADTOOLS 16. You can also follow these instructions when upgrading from an earlier version of LEADTOOLS.

Upgrading requires the following steps:

1. Install LEADTOOLS 16. Note the following:

By default LEADTOOLS 16 is installed into a different folder than previous versions.

2. Open your project and remove each old LEAD control as follows. (You can use the tab key to make sure that you find all of the controls on a form.)

a. Before removing a control, note all of the events where procedures are assigned. Later, you will have to reassign them to the new control.

b. Also, before removing a control, note the control name, and any other properties that you may need to assign to the new control. (You only need to note properties that are set to non-default values at design time.)

c. Press the Delete key to remove the control.

3. Close your project.

4. Remove the old LEAD icon from the toolbar as follows:

a. On the File menu, select the Open Project option.

b. Select the CBuilder3\Lib directory, highlight DCLUSR35.bpk and click Open.

c. Delete the USERES and USEUNIT lines pertaining to LEAD controls.

d. From the Project menu, select Build DCLUSR35. When asked to confirm that you are about to compile DCLUSR35, select Yes.

e. Once compiling has finished, select OK in the Compiling dialog.

f. In the Information dialog you will see a message indicating the controls that are no longer registered. Click OK.

5. Install the new LEAD control as follows:

a. On the main menu, select the Component->Import ActiveX Control option.

b. Highlight the LEAD Main ActiveX Control (16). Change the class name to TLEAD. Click Install. A Confirm dialog will appear indicating that the LEADLib_TLB.cpp file already exists and asking if you want to replace it. Click Yes.

c. In the Install dialog, click OK.

d. In the Confirm dialog, click Yes. You will also see another dialog confirming that DCLUSR35 will be compiled. Click OK.

e. After compilation has finished, click OK in the Information dialog.

f. At this point you will be presented with the DCLUSR35.cpp window, with USERES and USEUNIT lines pertaining to the new LEAD control. Save the DCLUSR35 project.

6. Add each new LEAD control as follows:

a. Open your project.

b. Select the LEAD icon and draw the control on the form.

c. In the Object Inspector, specify the Name and any other non-default properties that you noted earlier.

d. In the Object Inspector, specify any event procedures that you noted earlier. (You can choose them from the list box.)

7. Run your application to test it.