Home SpTBXLib VELVEx MultiInstaller Skin Editor

Reference

TVirtualExplorerListviewEx

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.