This property refers to the image handle of the base image

[C++Builder]   imagekitcontrolname->ImageHandle[= NativeUInt ]
[Delphi]   imagekitcontrolname.ImageHandle[= THandle ]

Property Value

The image handle of the base image.

Explanation

The ImageHandle property refers to the image handle of the base image. Although it is possible to set the image handle of the image directly into the ImageHandle property, if the LayerNo property is set to -1 and the file is loaded then the image handle is automatically set in the ImageHandle property. It is possible to set either a raster or a vector image as the base image. In earlier versions of the ImageKit, the base image could only be a raster image but now the ImageKit Control will allow you to display either raster or vector image data as the base image.

Note that when your are in edit mode and the ImageHdc property is being used, even when the image data referred to by the ImageHandle property is altered, those changes will not be shown on the screen unless that image data is reloaded.

To disable the image data, set the ImageHandle property to 0. The image data referred to by this image handle will automatically be freed from the memory.

When the ImageHandle property value changes the image data is automatically freed regardless of whether the FreeMemory method is executed.

Setting this value

  This value can be set at run-time.

Retrieving this value

  This value can be retrieved at run-time.

Differences from ImageKit7/8

  This property's type has changed from Long to LONG_PTR

 

The ImageKit10 VCL is a product created by Newtone Corporation