ShellBrowserComponents Delphi Editionv8.0

TJamShellTree displays the shell namespace of Windows in a tree, which looks and behaves exactly like the left pane of the Windows Explorer. When the user right clicks on a folder, it will automatically show the shell context menu. TJamShellTree is derived from Delphi"s TreeView control, so it is easy to use the TJamShellTree if you already familiar with Delphi"s TreeView control. The tree can be rooted at any folder, including special folders like the Control Panel. The component supports OLE Drag and Drop. You can synchronize it with other ShellBrowser controls using the TJamShellLink component. With the linked TJamShellLink it is also possible to use checkboxes in the TJamShellTree. The look and behavior of the control is highly customizable.

TJamShellList displays the contents of a folder in a list, which looks and behaves exactly like the right pane of the Windows Explorer. You can switch between the view styles Details, Small Icons, Large Icons, List and Thumbnails. Every thumbnail of an image is loaded in its own thread. Use the Popup property to merge your Delphi popup menus with the Shell context menu.The background context menu is supported as you can see in the right screenshot. Furthermore, you can use a background image. The features of the TJamShellTree described above are also implemented in the TJamShellList.

TJamSystemShellView displays the contents of a folder in a ListView like control. It is a true instance of the right pane of the Windows Explorer and therefore looks and behaves exactly like the Windows Explorer on the system it is running on. You can switch between the view styles Details, Small Icons, Large Icons, List and Thumbnails. As you see in the screenshot, it also supports the background context menu.

TJamShellCombo behaves like a combo box in the Windows Explorer. Usually you will just drop this component on a form and assign its ShellLink property to a TJamShellLink, everything else will be done automatically by the ShellBrowser Components.

TJamThumbnailImage displays a thumbnail image of a file or folder. The image is extracted by using the same API calls that the Windows Explorer uses, so the result is similar and any installed Shell Extensions are used automatically. You may either set the Path property to set a path to a file or folder for which the thumbnail image should be displayed, or you may synchronize it to a TJamShellList or TJamShellTree using the ShellLink property. The size of the thumbnail image will be adjusted automatically to fit the current size of the control.

TJamShellLink is a non visual control, which is able to synchronize several of the visual shell components TJamShellTree, TJamShellList and TJamShellCombo. Just drop a TJamShellLink component to this form and assign the ShellLink property of all shell components to the ShellLink component. You can refresh all connected shell controls by using the Refresh method. You can disable a ShellLink component temporarily by using the Enabled property. If you want to use CheckBoxes in a TJamShellTree or TJamShellList, they must be connected to a TJamShellLink. The ShellLink will synchronize the selected files and folder in the different shell controls.

TJamFileList can be used to list files and folders from different directories in one list. You can use the Add() method to add files or folders to the list. Additionally a multi-threaded file search similar to the Windows file search can be performed. The files that should be included in the result, can be defined in detail, e.g. by file date or file size and of course using a pattern like *.txt. Again, a thumbnail view is supported by this control.

TJamDriveList lists all local and network drives of the system. It also displays the capacity and the free space of each drive. You can use the Add method to add files or folders to the list.

TJamPathLabel is a component that displays paths in a label. In case the path name is longer than the label, it replaces the inner part of the path with \...\ so that the trailing portion of the path can be displayed with the full file name. Use the property to assign the path that should be displayed.

TJamPathEdit is a component that allows the user to enter a path or to browse for it. The user can open a browse dialog by pressing the button on the right. Use the Path property to set a default path or to get the path that the user has finally chosen. Use the FolderMode property to define if the user should enter / browse for a path to a file or a folder.

TJamBrowseForFolder displays a Windows dialog box for selecting and opening folders. It has to be activated like a TOpenDialog, with the call to the Execute Method. The selected folder will be assigned to the property Path.

TJamFolderCombo is a component that allows to display folders and drives in a combo box with its associated icons. Use the IncludeDrives property to show all available drives to the combo box. Use the AddFolder method to add a new folder to the combo box.

TJamNetConnectionDialog is a component, with which the user can easily connect a net drive.

TJamNetDisconnectDialog is a component, that shows after its execution a window with all connected net drives. Here the user can select, which net drive should be disconnected.

TShellBrowser is an invisible component. The property Folder contains the path of the current folder, ObjectName contains the name of the current object. Use the method Next to enumerate the objects in the current folder. IconNumber contains the number of the corresponding icon of the current object in the system icon list. The method ShowContextMenu shows the context menu of the current object at a given point. You can shuffle your own popup menus together with the explorer context menu. InvokeContextMenuCommand will execute a command of the context menu, for example "properties", "default" or "delete". Use IsFolder to check if the current object is a folder. Use a TJamSystemImageList component to get the icons of files and folders.

Use TJamSystemImageList to get access to the system image list of Windows. This can be useful if you want to display shell related information in a Delphi TListView or TTreeView. Then just place a TJamSystemImageList component on your form and assign it to the Images property of the TTreeView or TListView. Use the Size property to switch between small and large icons. GetIndexFromExtension and GetIndexFromFileName will return the icon number for a given extension or filename. Use the Draw and GetBitmap methods of Delphi`s TCustomImageList component to draw an icon somewhere on a TCanvas or to retrieve it as bitmap.

Use TJamShellChangeNotifier to get information about changes in the file system (copy, move or delete operations) and other changes relevant for shell operations. The Directory property decides which part of the shell namespace will be watched for changes.

TJamFileOperation is a component used to perform file operations, like copy, move, rename or delete. It has to be activated like a TOpenDialog, with the call to the Execute Method. The selected operation will be performed to the files in the property SourceFiles. To use the component, you have to add the files to which the operation should be performed, to the SourceFiles property, set the Destination path, choose the Operation, which should be performed, and call the Execute method.

TJamDropFiles is a component that manages Drag and Drop operations. It provides the name of the file, which is dropped on the related component and with its events, you can add the name of the file to a ListBox, for example. More examples are available in our demo application JAMDragDrop.