Unit:
VirtualExplorerListviewEx
Hierarchy:
TVirtualExplorerListview - TCustomVirtualExplorerListviewEx - TVirtualExplorerListviewEx
Description:
TVirtualExplorerListviewEx (VELVEx) is a control derived from TVirtualExplorerListview that adds Icon, Small Icon, List, and Thumbnail view styles.
The VirtualExplorerListviewEx component creates a Unicode enabled TListview (thanks to Troy Wolbrink's Unicode enabled VCL code) that is implemented by and kept synchronized to the VirtualExplorerListviewEx.
It adds the following methods, properties and events:
Public:
- procedure SyncInvalidate;
Forces a repaint in the component Canvas.
- procedure SyncItemsCount;
Syncs the items count between the VT and the ChildListview, this is used internally.
- procedure SyncOptions;
Syncs the options between the VT and the ChildListview. Normally used when the VT options are changed by code at runtime and the ViewStyle is not vsxReport.
- procedure SyncSelectedItems(UpdateChildListview: boolean = True);
Syncs the selected and focused items between the VT and the ChildListview. Normally used when a Node is focused or selected by code at runtime and the current ViewStyle is not vsxReport, read the FAQ section for more information.
- property ImageLibrary: TThumbnailImageLibrary;
TThumbnailImageLibrary = (timNone, timGraphicEx, timImageEn, timEnvision, timImageMagick);
Specifies the image library that is being used.
- property ChildListview: TOLEListview;
The VCL TListview that is synchronized with the virtual tree, use this property to access the TListview properties when the ViewStyle is not vsxReport.
- property ExtensionsList: TExtensionsList;
A list that contains all the known image file type extensions that VELVEx can load in thumbnail mode.
- property ExtensionsExclusionList: TExtensionsList;
A list that contains the file extensions that should be excluded from creating the thumbnails.
- property ShellExtractExtensionsList: TExtensionsList;
A list that contains the file extensions that should be loaded by the shell even if UseShellExtract is False. Suppose you only want images + html thumbnails, then you should turn off UseShellExtract to disable the extraction of additional shell supported files (doc, xls, etc) and then add '.html' to the ShellExtractExtensionsList.
Published:
- property ThumbsOptions: TThumbsOptions;
General thumbnail options, see TThumbsOptions for more info.
- property ViewStyle: TViewStyleEx;
TViewStyleEx = (vsxIcon, vsxSmallIcon, vsxList, vsxReport, vsxThumbs);
Indicates how the listview displays the items.
- OnThumbThreadClass
Occurs when the thumbnail thread needs to be created, use this event to use a custom thread to create the thumbnails.
- OnThumbsCacheItemAdd
Occurs when a thumbnail is about to be added to the cache after it was processed. This event could be used to store the thumbnail in an external database.
- OnThumbsCacheItemLoad
Occurs when a thumbnail was loaded from the cache. This event could be used to reload or change the loaded thumbnail.
- OnThumbsCacheItemRead
Occurs when a thumbnail must be read from the cache. This event could be used to provide the thumbnail from an external database.
- OnThumbsCacheItemProcessing
Occurs when a thumbnail must be created. This event could be used to override the default thumbnail creation.
- OnThumbsCacheLoad
Occurs when the cache was loaded from file. This event could be used to load the cache from an external database.
- OnThumbsCacheSave
Occurs when the cache is about to be saved. This event could be used to save the cache to an external database.
- OnThumbsDrawBefore
Occurs before the thumbnail is painted. Typically used to paint the background of the thumbnail.
- OnThumbsDrawAfter
Occurs after the thumbnail is painted. Typically used to paint borders or text on top of the drawed thumbnail.
- OnThumbsDrawHint
Occurs when the hint must be painted.
- OnThumbsGetDetails
Occurs when the file details must be painted in the thumbnail. Use this event to change the details of the file.
|