Codejock Software Migration Guide

Codejock Software's migrating guide notes include all API changes that you must apply in your application.

[ Home ]

Version 10.1.0
Released: April 5, 2006
ActiveX:
  1. Calendar
    • The Data Base data provider DB structure changed:

      * Table 'Event'
      - Field renamed: from Description to Body
      - New field added: ScheduleID type: Number
      - New field added: IsReminder type: Number

      * Table 'RecurrencePattern'
      - New field added: CustomPropertiesXMLData type: Memo

      If you need to use old mdb data fiels with a version 10 - please make corresponding changes manually.
    • GetProperty(XTP_CALENDAR_PROP_DBProviderCacheMode) changed to GetCacheMode
      SetProperty(XTP_CALENDAR_PROP_DBProviderCacheMode) changed to SetCacheMode
    • xtpCalendarDBCacheModeOnRepeat
      xtpCalendarDBCacheModeOnClear
      xtpCalendarDBCacheModeOff

      Renamed as:
      xtpCalendarDPCacheModeOnRepeat
      xtpCalendarDPCacheModeOnClear
      xtpCalendarDPCacheModeOff
Version 9.8.0
Released: September 26, 2005
ActiveX:
  1. Suite Pro
    • Xtreme Suite ActiveX has had some significant changes made that need to be noted before updrading to 9.80 and above.

      The TaskPanel and ShortcutBar controls have been removed from the SuiteCtrls.OCX file. Both the TaskPanel and ShortcutBar have their own OCX file. Important please note that all changes should be made by opening up the files in a text editor such as WordPad. Do not open up the project and try to edit it with Visual Studio.
    • To upgrade existing VB6 project please follow the steps below:

      Adding the GUID for TaskPanel and ShortcutBar Controls
      1. If you are using the TaskPanel control add the following GUID to the .vbp and all .frm files the TaskPanel is used on: 
            Object={B8E5842E-102B-4289-9D57-3B3F5B5E15D3}#9.80#0; TaskPanel.ocx
      2. If you are using the ShortcutBar control add the following GUID to the .vbp and all .frm files the ShortcutBar is used on: 
            Object={C8E5842E-102B-4289-9D57-3B3F5B5E15D3}#9.80#0; ShortcutBar.ocx
      Removing Uneeded GUIDs if Neccessary
      1. If you do not use any other controls from the SuiteCtrls.OCX file from version before 9.80 then you can remove the GUID for the Suite Control from the .vbp and all .frm files: 
            Object = "{A8E5842E-102B-4289-9D57-3B3F5B5E15D3}#9.60#0"; "SuiteCtrls.ocx"
      Renaming Control Names in .frm Files
      1. Change all occurences of XtremeSuiteControls.TaskPanel to XtremeTaskPanel.TaskPanel in each .frm file that contains a TaskPanel control.
      2. Change all occurences of XtremeSuiteControls.ShortcutBar to XtremeShortcutBar.ShortcutBar in each .frm file that contains a ShortcutBar control.
      Renaming Event Handler Parameters
      1. Change all occurences of XtremeSuiteControls.ITaskPanel to XtremeTaskPanel.ITaskPanel in each .frm file that contains a TaskPanel control.
      2. Change all occurences of XtremeSuiteControls.ITaskPanelItem to XtremeTaskPanel.ITaskPanelItem in each .frm file that contains a TaskPanel control.
      3. Change all occurences of XtremeSuiteControls.ITaskPanelGroupItem to XtremeTaskPanel.ITaskPanelGroupItem in each .frm file that contains a TaskPanel control.
      4. Change all occurences of XtremeSuiteControls.ITaskPanelGroup to XtremeTaskPanel.ITaskPanelGroup in each .frm file that contains a TaskPanel control.
      5. Change all occurences of XtremeSuiteControls.IShortcutBarItem to XtremeShortcutBar.IShortcutBarItem in each .frm file that contains a ShortcutBar control.
      You can use Help\UpgradeFrom970.vbs script to upgrade all files.
    • To upgrade existing C# .NET project please follow the steps below:

      Adding the TaskPanel and ShortcutBar References
      1. If you are using the TaskPanel control add the reference after the XtremeSuiteControls reference in the .csproj file: 
                        
<Reference
    Name = "XtremeTaskPanel"
    Guid = "{B8E5842E-102B-4289-9D57-3B3F5B5E15D3}"
    VersionMajor = "9"
    VersionMinor = "80"
    Lcid = "0"
    WrapperTool = "tlbimp"
/>
<Reference
    Name = "AxXtremeTaskPanel"
    Guid = "{B8E5842E-102B-4289-9D57-3B3F5B5E15D3}"
    VersionMajor = "9"
    VersionMinor = "80"
    Lcid = "0"
    WrapperTool = "aximp"
/>
      2. If you are using the ShortcutBar control add the reference after the XtremeSuiteControls reference in the .csproj file: 
                        
<Reference
    Name = "XtremeShortcutBar"
    Guid = "{C8E5842E-102B-4289-9D57-3B3F5B5E15D3}"
    VersionMajor = "9"
    VersionMinor = "80"
    Lcid = "0"
    WrapperTool = "tlbimp"
/>
    <Reference
    Name = "AxXtremeShortcutBar"
    Guid = "{C8E5842E-102B-4289-9D57-3B3F5B5E15D3}"
    VersionMajor = "9"
    VersionMinor = "80"
    Lcid = "0"
    WrapperTool = "aximp"
/>
      3. Important If your application still uses the PopupControl or TabControl you must update the VersionMajor and VersionMinor properties of the XtremeSuiteControls and AxXtremeSuiteControls reference in the .csproj file to the current major and minor version to avoid ambiguities.

      Removing Uneeded References if Neccessary
      1. If you do not use any other controls from the SuiteCtrls.OCX file from versions before 9.80 (Popup Control or Tab Control) then you can remove the XtremeSuiteControls reference in the .csproj file: 
                
<Reference
    Name = "XtremeSuiteControls"
    Guid = "{A8E5842E-102B-4289-9D57-3B3F5B5E15D3}"
    VersionMajor = "9"
    VersionMinor = "60"
    Lcid = "0"
    WrapperTool = "tlbimp"
/>
<Reference
    Name = "AxXtremeSuiteControls"
    Guid = "{A8E5842E-102B-4289-9D57-3B3F5B5E15D3}"
    VersionMajor = "9"
    VersionMinor = "60"
    Lcid = "0"
    WrapperTool = "aximp"
/>
      Updating "using" statements
      1. If using the TaskPanel control, then add the following to all .cs files that may need it: 
            using XtremeTaskPanel;
      2. If using the ShortcutBar control, then add the following to all .cs files that may need it: 
            using XtremeShortcutBar;
      Renaming Control Names in .cs Files
      1. Change all occurences of AxXtremeSuiteControls.AxTaskPanel to AxXtremeTaskPanel.AxTaskPanel in each .cs file that contains a TaskPanel control.
      2. Change all occurences of AxXtremeSuiteControls.AxShortcutBar to AxXtremeShortcutBar.AxShortcutBar in each .cs file that contains a ShortcutBar control.
      3. Change all occurences of AxXtremeSuiteControls.AxShortcutCaption to AxXtremeShortcutBar.AxShortcutCaption in each .cs file that contains a ShortcutBar Caption control.
      Renaming Event Handler Parameters
      1. Change all occurences of AxXtremeSuiteControls._DTaskPanelEvents_xxxxEvent to AxXtremeTaskPanel._DTaskPanelEvents_xxxxEvent in each .cs file that contains a TaskPanel control.
      2. Change all occurences of AxXtremeSuiteControls._DShortcutBarEvents_xxxxEvent to AxXtremeShortcutBar._DShortcutBarEvents_xxxxEvent in each .cs file that contains a ShortcutBar control.
      Renaming XtremeSuiteControls Object References
      1. Search through all your .cs files for the "XtremeSuiteControls" string. Update the string to "XtremeTaskPanel" if it refers to a TaskPanel Object. Search through all your .cs files for the "XtremeSuiteControls" string. Update the string to "XtremeShortcutBar" if it refers to a ShortcutBar Object. Search through all your .cs files for the "XtremeSuiteControls" string. Update the string to "XtremeShortcutBarCaption" if it refers to a ShortcutBarCaption Object.
  2. Command Bars
    • Important Note: The values for the theme enumeration have been changed. You will need to check to make sure that your theme has been set correctly if you used the CommandBars Designer Studio (*.XML or *.XCB), or if you set the theme at design time in Visual Studio. If you set the theme via code using a theme enumeration value then you do not need to make changes. Effected themes are Default, Office XP, and Office 2003.
  3. Docking Pane
    • Important Note: The values for the theme enumeration have been changed. You will need to check to make sure that your theme has been set correctly if you hard coded the theme (used the integer representation of the theme), or if you set the theme at design time in Visual Studio. If you set the theme via code using a theme enumeration value then you do not need to make changes. Effected themes are Office 2003 and Visio.