Programs that use controls from earlier versions of the
ImageKit:
Unfortunately, it is not possible to simply exchange the older
ImageKit controls with the new ImageKit10 VCL controls and run the
program. There are a number of differences between the earlier
versions of the ImageKit and the ImageKit10VCL that must be
considered. These differences are explained below and the
conversion from earlier versions of the ImageKit to the ImageKit10
VCL is not at all difficult. It should be pointed out that all
versions of the ImageKit VCL controls can coexist within the same
application. The image handle used by the earlier versions of the
ImageKit can be passed to the ImageKit10 VCL controls allowing you
to use the newer ImageKit10 VCL functionality. However, the
ImageKit10, like the ImageKit8 and ImageKit7 before it, does not
provide the individual controls that existed in ImageKit6 or
earlier versions. In these early versions, controls such as the
Common Control, Display Control, Effect Control, File Control,
Print Control, Scan Control, Slideshow Control were separate
controls. These controls have been discontinued and their
functionality has been incorporated into the single ImageKit
Control. The Slideshow Control has been discontinued completely and
is no longer included in the ImageKit10 VCL
ImageKit5
(1) Property names that have changed (ImageKit5 --> ImageKit10 VCL)
Thumbnail Control
BackColor --> Color
Hwnd --> Handle
(2) Other changes
Changes to parameters or return values specific to a particular method or event are listed at the bottom of that method or event page in the section called Differences from ImageKit5.
General changes to method and event parameters:
Strings - ActiveX WideString type and BSTR type have been
changed to UnicodeString in VCL.
Integers - In ActiveX, C++Builder uses the long type. This
has been changed to int in VCL.
Boolean - In ActiveX, Delphi uses the WordBool type. This
has been changed to Boolean in VCL.
ImageKit6
(1) Properties that have been deleted (ImageKit6 --> ImageKit10 VCL)
Thumbnail Control
EnableOLEDrag,
MouseCursorTypeFile
*MouseCursorTypeFile property is now
the Cursor property.
(2) Property names that have changed (ImageKit6 --> ImageKit10 VCL)
Thumbnail Control
BackColor --> Color
ForeColorUp --> ForeColor
Hdc --> Canvas.Handle
Hwnd --> Handle
MouseCursor --> SelectCursor
MouseCursorType --> Cursor
PictureUp --> Picture
PictureUpFile --> PictureFile
(3) Other changes
Changes to parameters or return values specific to a particular method or event are listed at the bottom of that method or event page in the section called Differences from ImageKit6.
General changes to method and event parameters:
Strings - ActiveX WideString type and BSTR type
have been changed to UnicodeString in VCL.
Integers - In ActiveX, C++Builder uses the long
type. This has been changed to int in VCL.
Boolean - In ActiveX, Delphi uses the WordBool
type. This has been changed to Boolean in VCL.
ImageKit6 VCL
(1) Property names that have changed (ImageKit6 VCL --> ImageKit10 VCL)
Thumbnail Control
ForeColorUp --> ForeColor
PictureUp --> Picture
PictureUpFile --> PictureFile
(*)
ThumbSelectCursor -->
SelectCursor
How to migrate:
Appropriate
changes must be made to the dfm, pas, and cpp files.
(2) Other changes
Changes to parameters or return values specific to a particular method or event are listed at the bottom of that method or event page in the section called Differences from ImageKit6 VCL.
(3) Specification change
The orientation of the displayed image may be different due to the addition of the ExifAutoRotate property of the thumbnail control. Set the ExifAutoRotate property to False for the same behavior as the previous ImageKit. Change the trigger condition of MouseMoveOnThumb event of thumbnail control.
ImageKit7 ActiveX
(1) Properties that have been deleted (ImageKit7 ActiveX --> ImageKit10 VCL)
A. ImageKit Control
EnableOLEDrag, MouseCursorFile,
RectMouseCursorFile
*MouseCursorFile
property is now the Cursor property
*RectMouseCursorFile property is now the RectCursor property
PanWindow.MouseCursorFile,
PanWindow.RectMouseCursorFile
*PanWindow.MouseCursorFile property is now the PanWindow.Cursor
property
*PanWindow.RectMouseCursorFile property is now the
PanWindow.RectCursor property
Scan.DsNameCount,
Scan.HalfToneList
B. Thumbnail Control
EnableOLEDrag,
MouseCursorFile
*MouseCursorFile
property is now the Cursor property
(2) Property names that have changed (ImageKit7 ActiveX --> ImageKit10 VCL)
A. ImageKit Control
BackColor --> Color
Hdc --> Canvas.Handle
Hwnd --> Handle
MouseCursorType -->
Cursor
RectMouseCursorType -->
RectCursor
Edit.ToolBarMouseCur -->
Edit.ToolBarCursor
File --> FileIO
File.JPEG2000NumrResLevel
--> File.JPEG2000NumResLevel
Magnifier.Type -->
Magnifier.Style
PanWindow.Hwnd -->
PanWindow.Handle
PanWindow.MouseCursorType
--> PanWindow.Cursor
PanWindow.RectMouseCursorType
--> PanWindow.RectCursor
PrintDraw.Hdc -->
PrintDraw.Handle
Scan.DsName -->
Scan.DataSourceName
Scan.DsNameList -->
Scan.DataSourceNameList
Scan.HalfTone -->
Scan.Halftone
B. Thumbnail Control
BackColor --> Color
ForeColorUp -->
ForeColor
Hdc --> Canvas.Handle
Hwnd --> Handle
MouseCursor -->
SelectCursor
MouseCursorType -->
Cursor
PictureUp --> Picture
PictureUpFile -->
PictureFile
(3) Method name changes (ImageKit7 ActiveX --> ImageKit10 VCL)
A. ImageKit Control
GetPalette -->
GetPaletteFromImage
SetPalette -->
SetPaletteToImage
Scan.CloseDS -->
Scan.CloseDataSource
Scan.Exec -->
Scan.Execute
Scan.GetCapEnum -->
Scan.GetCapEnumToFloat, Scan.GetCapEnumToString
Scan.GetDSInfo -->
Scan.GetDataSourceInfo
Scan.IsOpenDS -->
Scan.IsOpenDataSource
Scan.OpenDS -->
Scan.OpenDataSource
(4) Specification change
By adding the FileIO.ExifAutoRotate property of the Image Kit control and the ExifAutoRotate property of the thumbnail control, the orientation of the displayed image may be different. Set the ExifAutoRotate property to False for the same behavior as the previous ImageKit. Change the trigger condition of MouseMoveOnThumb event of thumbnail control.
(5) Other changes
Changes to parameters or return values specific to a particular method or event are listed at the bottom of that method or event page in the section called Differences from ImageKit7 ActiveX.
General changes to method and event parameters:
Strings - ActiveX WideString type and BSTR type have been
changed to UnicodeString in VCL.
Integers - In ActiveX, C++Builder uses the long type. This
has been changed to int in VCL.
Boolean - In ActiveX, Delphi uses the WordBool type. This
has been changed to Boolean in VCL.
ImageKit7 VCL
(1) Property names that have changed (ImageKit7 VCL --> ImageKit10 VCL)
Thumbnail Control
ForeColorUp --> ForeColor
PictureUp --> Picture
PictureUpFile --> PictureFile
(*)
ThumbSelectCursor -->
SelectCursor
How to migrate:
Appropriate
changes must be made to the dfm, pas, and cpp files.
(2) Specification change
By adding the FileIO.ExifAutoRotate property of the Image Kit control and the ExifAutoRotate property of the thumbnail control, the orientation of the displayed image may be different. Set the ExifAutoRotate property to False for the same behavior as the previous ImageKit. Change the trigger condition of MouseMoveOnThumb event of thumbnail control.
(3) Other changes
Changes to parameters or return values specific to a particular method or event are listed at the bottom of that method or event page in the section called Differences from ImageKit7 VCL.
ImageKit8 ActiveX
(1) Properties that have been deleted (ImageKit8 ActiveX --> ImageKit10 VCL)
A. ImageKit Control
EnableOLEDrag, MouseCursorFile,
RectMouseCursorFile
*MouseCursorFile
property is now the Cursor property
*RectMouseCursorFile property is now the RectCursor property
PanWindow.MouseCursorFile,
PanWindow.RectMouseCursorFile
*PanWindow.MouseCursorFile property is now the PanWindow.Cursor
property
*PanWindow.RectMouseCursorFile property is now the
PanWindow.RectCursor property
Scan.DsNameCount,
Scan.HalfToneList
B. Thumbnail Control
EnableOLEDrag,
MouseCursorFile
*MouseCursorFile
property is now the Cursor property
(2) Property names that have changed (ImageKit8 ActiveX --> ImageKit10 VCL)
A. ImageKit Control
BackColor --> Color
Hdc --> Canvas.Handle
Hwnd --> Handle
MouseCursorType -->
Cursor
RectMouseCursorType -->
RectCursor
Edit.ToolBarMouseCur -->
Edit.ToolBarCursor
File --> FileIO
File.JPEG2000NumrResLevel
--> File.JPEG2000NumResLevel
Magnifier.Type -->
Magnifier.Style
PanWindow.Hwnd -->
PanWindow.Handle
PanWindow.MouseCursorType
--> PanWindow.Cursor
PanWindow.RectMouseCursorType
--> PanWindow.RectCursor
PrintDraw.Hdc -->
PrintDraw.Handle
Scan.DsName -->
Scan.DataSourceName
Scan.DsNameList -->
Scan.DataSourceNameList
Scan.HalfTone -->
Scan.Halftone
B. Thumbnail Control
BackColor --> Color
ForeColorUp -->
ForeColor
Hdc --> Canvas.Handle
Hwnd --> Handle
MouseCursorType -->
Cursor
SelectMouseCursorType -->
SelectCursor
PictureUp --> Picture
PictureUpFile -->
PictureFile
(3) Method name changes (ImageKit8 ActiveX --> ImageKit10 VCL)
A. ImageKit Control
GetPalette -->
GetPaletteFromImage
SetPalette -->
SetPaletteToImage
Edit.Property -->
Edit.ShowPropertyDialog
Scan.CloseDS -->
Scan.CloseDataSource
Scan.Exec -->
Scan.Execute
Scan.GetCapEnum -->
Scan.GetCapEnumToFloat, Scan.GetCapEnumToString
Scan.GetDSInfo -->
Scan.GetDataSourceInfo
Scan.IsOpenDS -->
Scan.IsOpenDataSource
Scan.OpenDS -->
Scan.OpenDataSource
(4) Specification change
By adding the FileIO.ExifAutoRotate property of the Image Kit control and the ExifAutoRotate property of the thumbnail control, the orientation of the displayed image may be different. Set the ExifAutoRotate property to False for the same behavior as the previous ImageKit. Change the trigger condition of MouseMoveOnThumb event of thumbnail control.
(5) Other changes
Changes to parameters or return values specific to a particular method or event are listed at the bottom of that method or event page in the section called Differences from ImageKit8 ActiveX.
General changes to method and event parameters:
Strings - ActiveX WideString type and BSTR type have been
changed to UnicodeString in VCL.
Integers - In ActiveX, C++Builder uses the long type. This
has been changed to int in VCL.
Boolean - In ActiveX, Delphi uses the WordBool type. This
has been changed to Boolean in VCL.
ImageKit8 VCL
(1) Property names that have changed (ImageKit8 VCL --> ImageKit10 VCL)
Thumbnail Control
ForeColorUp -->
ForeColor
PictureUp --> Picture
PictureUpFile -->
PictureFile (*)
How to migrate:
Appropriate
changes must be made to the dfm, pas, and cpp files.
(2) Enumeration that have changed
TVIkScanUnit
vikScanMillimeters -->
vikScanMillimeter
How to migrate:
Appropriate
changes must be made to the pas and cpp files.
(3) Specification change
By adding the FileIO.ExifAutoRotate property of the Image Kit control and the ExifAutoRotate property of the thumbnail control, the orientation of the displayed image may be different. Set the ExifAutoRotate property to False for the same behavior as the previous ImageKit. Change the trigger condition of MouseMoveOnThumb event of thumbnail control. For details, refer to [Difference with ImageKit 6/7/8/9 VCL] in Reference.
(4) Other changes
Changes to parameters or return values specific to a particular method or event are listed at the bottom of that method or event page in the section called Differences from ImageKit8 VCL.
ImageKit9/10 ActiveX
(1) Properties that have been deleted (ImageKit9/10 ActiveX --> ImageKit10 VCL)
A. ImageKit Control
EnableOLEDrag, MouseCursorFile,
RectMouseCursorFile
*MouseCursorFile
property is now the Cursor property
*RectMouseCursorFile property is now the RectCursor property
PanWindow.MouseCursorFile,
PanWindow.RectMouseCursorFile
*PanWindow.MouseCursorFile property is now the PanWindow.Cursor
property
*PanWindow.RectMouseCursorFile property is now the
PanWindow.RectCursor property
Scan.DsNameCount,
Scan.HalfToneList
B. Thumbnail Control
EnableOLEDrag,
MouseCursorFile
*MouseCursorFile
property is now the Cursor property
C. Play Control
MouseCursorFile
*MouseCursorFile
property is now the Cursor property
D. Preview Control
MouseCursorFile
*MouseCursorFile
property is now the Cursor property
E. Record Control
MouseCursorFile
*MouseCursorFile
property is now the Cursor property
(2) Property names that have changed (ImageKit10 ActiveX --> ImageKit10 VCL)
A. ImageKit Control
BackColor --> Color
EnableTouch --> Touch
Hdc --> Canvas.Handle
HWND --> Handle
MouseCursorType -->
Cursor
RectMouseCursorType -->
RectCursor
Edit.ToolBarMouseCur -->
Edit.ToolBarCursor
File --> FileIO
File.JPEG2000NumrResLevel
--> File.JPEG2000NumResLevel
Magnifier.Type -->
Magnifier.Style
PanWindow.Hwnd -->
PanWindow.Handle
PanWindow.MouseCursorType
--> PanWindow.Cursor
PanWindow.RectMouseCursorType
--> PanWindow.RectCursor
PrintDraw.Hdc -->
PrintDraw.Handle
Scan.DsName -->
Scan.DataSourceName
Scan.DsNameList -->
Scan.DataSourceNameList
Scan.HalfTone -->
Scan.Halftone
B. Thumbnail Control
BackColor --> Color
EnableTouch --> Touch
ForeColorUp -->
ForeColor
Hdc --> Canvas.Handle
HWND --> Handle
MouseCursor -->
SelectCursor
MouseCursorType -->
Cursor
PictureUp --> Picture
PictureUpFile --> PictureFile
C. Play Control
BackColor --> Color
HWND --> Handle
MouseCursorType -->
Cursor
VideoHeight, VideoWidth -->
VideoSize
D. Preview Control
BackColor --> Color
HWND --> Handle
MouseCursorType -->
Cursor
VideoHeight, VideoWidth -->
VideoSize
E. Record Control
BackColor --> Color
HWND --> Handle
MouseCursorType -->
Cursor
VideoHeight, VideoWidth -->
VideoSize
(3) Method name changes (ImageKit10 ActiveX --> ImageKit10 VCL)
A. ImageKit9/10 ActiveX -> ImageKit10
VCL
GetPalette -->
GetPaletteFromImage
SetPalette -->
SetPaletteToImage
Edit.Property -->
Edit.ShowPropertyDialog
Scan.CloseDS -->
Scan.CloseDataSource
Scan.Exec -->
Scan.Execute
Scan.GetCapEnum -->
Scan.GetCapEnumToFloat, Scan.GetCapEnumToString
Scan.GetDSInfo -->
Scan.GetDataSourceInfo
Scan.IsOpenDS -->
Scan.IsOpenDataSource
Scan.OpenDS -->
Scan.OpenDataSource
B. ImageKit10 ActiveX -> ImageKit10 VCL
Image kit control File.PDF.End --> FileIO.PDF.Finish
(4) Specification change (ImageKit9 ActiveX ->ImageKit10 VCL)
By adding the FileIO.ExifAutoRotate property of the Image Kit control and the ExifAutoRotate property of the thumbnail control, the orientation of the displayed image may be different. Set the ExifAutoRotate property to False for the same behavior as the previous ImageKit. Change the trigger condition of MouseMoveOnThumb event of thumbnail control.
(5) Other changes
Changes to parameters or return values specific to a particular method or event are listed at the bottom of that method or event page in the section called Differences from ImageKit10 ActiveX.
General changes to method and event parameters:
Strings - ActiveX WideString type and BSTR type have been
changed to UnicodeString in VCL.
Integers - In ActiveX, C++Builder uses the long type. This
has been changed to int in VCL.
Boolean - In ActiveX, Delphi uses the WordBool type. This
has been changed to Boolean in VCL.
ImageKit9 VCL
(1) Specification change By adding the FileIO.ExifAutoRotate property of the Image Kit control and the ExifAutoRotate property of the thumbnail control, the orientation of the displayed image may be different. Set the ExifAutoRotate property to False for the same behavior as the previous ImageKit. Change the trigger condition of MouseMoveOnThumb event of thumbnail control.
For details, refer to [Difference with ImageKit 6/7/8/9 VCL] in Reference.
(2) Other For details, please refer to [Difference with ImageKit7/8/9 ActiveX/VCL] [Difference with ImageKit9 ActiveX/VCL] in Reference.