This event is generated when a thumbnail image is selected. Thumbnail images can be selected by clicking the mouse, using the keyboard, or executing the SelectImage method.
Parameters
| Name | Explanation |
|---|---|
| PathName | The directory name and path of the image that was selected |
| FileName | The file name of the image that was selected |
| ImageNumber | The sequential number of the thumbnail image |
| MaxImage | The total number of images to be loaded into the thumbnail control |
| ALeft | The position, in pixels, of the left side of the thumbnail frame that was selected. (This is the x coordinate of the top left corner of the thumbnail frame) |
| ATop | The position, in pixels, of the top of the thumbnail frame that was selected. (This is the y coordinate of the top left corner of the thumbnail frame) |
| ARight | The position, in pixels, of the left side of the thumbnail frame that was selected. (This is the x coordinate of the bottom right corner of the thumbnail frame) |
| ABottom | The position, in pixels, of the left side of the thumbnail frame that was selected. (This is the y coordinate of the bottom right corner of the thumbnail frame) |
Explanation
The SelectFile event is generated when a thumbnail image is selected. Thumbnail images can be selected by clicking the mouse, using the keyboard, or executing the SelectImage method. If the thumbnail image is not displayed on the Thumbnail Control then this event is not generated. Furthermore, if the selected thumbnail frame has no thumbnail displayed then the PathName and FileName parameters will contain empty strings. 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"
By pressing the Ctrl key while clicking with the mouse, several thumbnails can be selected or deselected. In either case, this event is generated. To determine whether or not a particular thumbnail image is selected, please use the IsSelected method.
Thumbnail images can be selected by clicking the mouse, using the keyboard, or executing the SelectImage method. By pressing the Shift key while clicking with the mouse, a series of thumbnails can be selected. This event is generated multiple times for each thumbnail image that has been selected.
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