StartLoadFile (Thumbnail Control/ Custom Event)

This event is generated before each image is loaded on the Thumbnail Control.

[C++Builder] thumbcontrolnameStartLoadFile(TObject *Sender, const UnicodeString PathName, const UnicodeString FileName, short ImageNumber, short MaxImage)

[Delphi] thumbcontrolnameStartLoadFile(Sender: TObject; const PathName, FileName: string; ImageNumber, MaxImage: Smallint)

Parameters

Name	Explanation
PathName	The path and directory name of the image loaded into the Thumbnail Control
FileName	The filename of the image loaded into the Thumbnail Control
ImageNumber	The sequential number of the thumbnail image
MaxImage	The total number of images to be loaded into the Thumbnail Control

Explanation

The StartLoadFile event is generated before each image is loaded on the Thumbnail Control. Note: This event is NOT generated if a thumbnail file (ThumbnailFile property) is used to load the images. To cancel processing in the Thumbnail Control, set the Cancel property to True within this event.

When multi-page image files are loaded, the page number is appended to the FileName parameter (If the page number is 0 then it is omitted).

Example: When page 2 of the file ABC.TIF is loaded into the thumbnail control, the FileName parameter will return the string "ABC.TIF 2".

Differences from ImageKit6/7/8/9/10 ActiveX

In C++Builder, the PathName and FileName parameters' type is changed to UnicodeString
In Delphi, the PathName and FileName parameter's type is changed to string