What's new?

V8.0.2 Released on 18 Jan 2012

TJamShellList: The property UseSystemFont can now be set to True if ParentFont is True. ParentFont will then be set to False automatically.
TJamShellList: The value for the ParentDoubleBuffered and the Font property now persist when closing and reopening the project.
Bugfix: A workaround that we introduced for a bug in the VCL T(Custom)ListView when OwnerDraw is set to True could cause a stack overflow. The workaround has been improved.
Bugfix: When sorting a TJamFileList by its "Name" column, now folders are sorted again on top of files.
Bugfix: TJamSystemShellView.CreateDir() with the parameter Editable = True now puts the item in edit mode again.
Bugfix: When a file was deleted in a TJamFileList e.g. using the DEL key, it was not removed from the list.
The help files have been improved.
Several minor fixes and improvements have been incorporated.

V8.0.1 Released on 29 Dec 2011

Improvement: A new sample project "CustomColumns" has been added which demonstrates the use of custom columns in a TJamShellList.
Improvement: The new help introduced with V8 has been improved and the file count has been reduced.
Improvement: A new static class TShellColumns has been introduced that supplies the Shell Column IDs of the most important shell columns.
Bugfix: The property TJamShellTree.RootedAtFileSystemFolder worked only the first time a value was assigned to.
Bugfix- TJamSystemShellView: Column headers are now correctly shown and hidden when switching between different ViewStyles.
Bugfix - TJamSystemShellView: In 64Bit builds the list could be empty after hitting a cursor key.
Bugfix - TJamSystemShellView: The context menu item "Open" now works correctly.
Bugfix: TJamFileList.IsColumnVisible(TShellColumns.ParentFolder) now returns the correct value.
Bugfix - TJamFileList: The Search() method now takes the time zone into account correctly.
Bugfix - TJamDriveList: Switching the visual style in the Windows Control panel unchecked all checked drives.
Bugfix - TJamDriveList: External exceptions e.g. from context menu extensions are now caught and suppressed.
Several minor fixes and improvements have been incorporated.

V8.0 Released on 30 Sep 2011

Improvement: Support for Delphi XE2 and the 64Bit compiler has been added.
Improvement: Windows Shell ItemIdLists are now stored using an interfaced object that implements the new IItemIdList interface. We use the reference counting of TInterfacedObject to free the memory of the wrapped ItemIdList. This allowed us to remove many lines of code in which ItemIdLists have been copied. Furthermore the path and the special folder (TJamShellFolder) are cached along with each ItemIdList. All this should lead to performance improvements. This is more an internal change and the code of most of our customers should not be affected by this change. In case you used the type PItemIdList in your code, it should be sufficient to change it to IItemIdList.
Improvement: The property IconSpacing has been added to TJamShellList and TJamFileList. It allows defining the spacing between the icons in pixels.
The help file is now generated based on the XML comments in the source code and is HTML-based now.
Improvement: The property TextColor has been added to the items shown in the components TJamShellTree, TJamShellList, TJamFileList and TJamDriveList. It allows modifying the text color of each item.
Improvement: On Windows 7 the context menu operations "delete" and "paste" are now again performed in background threads. Windows 2000/XP did this automatically, unfortunately Microsoft removed the asynchronous execution of shell context menu commands in Windows 7.
Improvement - TJamShellList: If the ViewStyle property is vsList, then sorting can now be triggered using the background context menu.
Improvement: The methods IsColumnVisible() and GetVisibleColumns have been added to TJamShellList and TJamFileList.
Improvement: TJamFolderCombo has a new property Sorted. If set to True, the items will appear in alphabetical order, if set to False, they will appear in the order they have been added.
Bugfix: A few repainting problems of the TJamShellCombo and TJamFolderCombo have been fixed.
Bugfix: Editing in TJamShellCombo was no longer working if the property ShowFullPath was set to True.
Bugfix: When TJamShellTree or ShowFullPath were assigned to a new parent control, they lost their selected folder.
TJamShellChangeNotifier: The event type neNetUnshare has been merged into the event neNetShare, because it was effectively never fired by Windows. The event type neNetShare occurs if a folder or drive is being shared, or the sharing is being revoked.
The default color of the property ThumbnailBorderColor of the classes TJamShellList and TJamFileList is now clNone which meets the style of Windows7/Vista.
The support for Delphi 6 and Windows 2000 has been removed. V7 which is compatible with Delphi 6 and Windows 2000 will remain available in our customer's area for registered users with valid maintenance.
The include file VER.INC has been made obsolete, we instead use conditional compiler statements like {$if CompilerVersion > 18}.
A major code cleanup was performed and numerous minor fixes and improvements have been incorporated.

V7.3.2 Released on 12 Jul 2011

Improvement: If the property ShellContextMenu of the TJamShellList is set to False, now also the background context menu is not shown any more.
Improvement: When performing a right mouse button drag from a readonly source, the resulting drop menu does no longer offer to move the file.
The property TJamFolderCombo.ItemIndex is no longer published but public now.
Bugfix: The method call TJamShellList.InvokeCommandOnSelected('default') showed an error if more than one file was selected.
Bugfix: TJamShellCombo could raise an unhandled exception when it was visible while the Windows theme was changed to "Windows classic" style.

V7.3.1 Released on 30 Jun 2011

Improvement: The method TJamShellList.SetColumnVisibility() now allows to turn on or off certain columns using its ShColumnId.
Bugfix: Setting TJamFolderCombo.Editable to False now has the intended effect that no edit field is available to the user.
Bugfix: Occasional "List index out of bounds" errors for the TJamDriveList have been resolved.
Bugfix: The context menu of the column header of the TJamShellList was shown at the wrong position in some cases.
Bugfix: After the user removed columns using the context menu of the column header, sorting was not always working correctly.
Bugfix: If the AutoSizeColumn property of the TJamShellList and TJamFileList was set to a value larger than the actual column count, then a stack overflow occurred.
Bugfix: Setting the path property of TJamBrowseForFolder did not have any effect with bfNewDialogStyle on Windows Vista and later.
Several minor fixes and improvements have been incorporated.

V7.3 Released on 14 Apr 2011

New Feature: TJamFileList and TJamShellList now include a context menu for the column headers that allows turning on or off certain columns.
New Feature: TJamDriveList has the new properties "WarnLevelPercent" and "ErrorLevelPercent". They can be used to change the color of the small bar chart which shows the free space in yellow or red, dependant on the percentage of free space. The default values are 8 and 2 percent. Set these properies to 0 if you do not want the color to be changed.
New Feature: The property "IconsBasedOnFileExtension" has been added to TJamShellList and TJamFileList. If set to True, icons will be queried from the system based on the file extension only. This is usually faster compared to using the full path. The most noticeable difference is for executable files, which will no longer show the included icon but a standard icon.
New Feature: The method AutoAdjustColumnWidths() has been added to TJamShellList and TJamFileList. If called, it adjusts the column width to an optimal value, just like the shortcut Ctrl + Num+ does in every ListView.
New Feature: The menu item "Paste Shortcut" has been added to the background context menu of the TJamShellList, just like it exists in the Windows Explorer. The chosen view type and sort column are now marked in the background context menu of TJamShellList.
New Feature: The new property TJamFileList.AllowDropToBackground lets you decide if files can be added to the list using drag and drop. The default value is True.
Improvement: The controls TJamShellCombo and TJamFolderCombo are now derived from TComboBoxEx instead of TComboBox. Since TComboBoxEx supports images and indents, we were able to remove our code for custom-drawing the items. The Windows XP Explorer also uses the Windows ComboBoxEx control for its address bar, that means our TJamShellCombo now looks more like the original Explorer control.
Improvement: The type of the property BackgroundImage in TJamShellList and TJamFileList has been changed from TBitmap to TPicture. That way other file types beside BMP are supported, e.g. JPG and PNG.
Improvement: We are now using Windows Vista style drag and drop cursors on Windows Vista and later.
Improvement: The event TJamSystemShellView.OnChanged has been added. It is triggered after a full refresh of the list or when the state of an item (e.g. selection) in the list has changed.
New Feature: The standard Windows 7 libraries have been added to the set of special folders in TJamShellFolder.
Improvement: The new class procedure TShellBrowser.SetThumbnailProvider() allows setting a callback function that is called for non-available thumbnails. This allows to support thumbnails for file formats for which Windows does not have a thumbnail provider installed.
Improvement: The CreateDir() method of TJamShellList and TJamShellTree now also works in a Windows 7 library.
Improvement: The inherited event OnCanResize is now published for all controls in Delphi 2010 and higher.
Improvement: The TJamBrowserForFolder dialog now uses the Vista style browse dialog on Windows Vista and higher and Delphi 2009 and higher.
Improvement: We are now using Windows API functions to deal with PItemIdLists instead of our own pointer arithmetic.
Improvement: The horizontal and vertical alignment of the thumbnails has been improved.
Improvement: Some sample projects have been improved.
Improvement: If TJamShellTree.FileSystemOnly is set to True, ZIP files are not listed any more as folders.
Improvement: Added new event OnInvalidPath to TJamSelectionList which is triggered whenever an invalid path is added to the list.
Bugfix: Adding an UNC path of non-reachable servers to the TJamDriveList no longer causes a delay (blocking) of the application.
Bugfix: The "Return" key now executes the default action for all files if multiple files are selected.
Bugfix: In the TJamFileList the first drawn item was not initialized correctly in some cases, this resulted in missing column details for the item.
Bugfix: An Access Violation could occur when setting TJamShellList.ViewStyle to the value vsReport if ShowExtraLargeIcons was True.
Bugfix: TJamSystemShellView.ItemCount could be 0 in the OnPopulated event.
Bugfix: When the property TJamSystemShellView.Filter is set, then "My Computer" is no longer displayed entirely empty.

V7.2.1: Released on 13 Oct 2010

The keyboard shortcut Alt+Up now goes up one level in TJamShellList and TJamSystemShellView, like in the Windows 7 Explorer.
The size of file in Windows 7 Libraries folders is now formatted in KB instead of Bytes.
Bugfix - TJamDriveList: fixed possible AV when using the OnAddItem event and having the property CheckIfExists set to True
Bugfix: The Windows Fonts folder was missing when the property FileSystemOnly was set to True.
Bugfix: A confirmation dialog, e.g. when deleting files, was sometimes not shown on top of the application.
A few minor fixes and improvements have been incorporated.

V7.2: Released on 23 Sep 2010

Added support for Delphi XE
The "New" submenu of the background context menu of the TJamShellList control is now filled like in the Windows Explorer, including "New Shortcut" and all file types registered for this menu.
The JamShellList is now resorted if new items have been added due to an automatic update.
Added overloaded version of TShellBrowser.GetColumnText() that works with a SHCOLUMNID instead of a column index
Added special folders SF_MY_MUSIC, SF_MY_PICTURES, SF_MY_VIDEOS to TJamShellFolder enumeration.
Added new event OnBeforeShellCommand to TJamShellTree
Now caching ItemIdLists of special folders in a static array, this improves the performance of the frequently used function TestForSpecialFolder().
The columns in Report mode are now filled correctly in Windows 7 Libraries folders
The TJamDriveList now shows network drives correctly in applications that have been started as administrator under Windows 7. Formerly they sometimes had a red cross as overlay icon.
Bugfix: The event TJamShellList.OnPathChanged was not triggered if the ShellLink property was not assigned.
Bugfix: The paths supplied by the TJamShellList.OnBeforeShellCommand event sometimes were empty for keyboard triggered operations.
Bugfix: TJamSystemShellView.Filter was not working.
Bugfix: In the TJamShellList the default "open" command was not working for files in ZIP archives.

V7.1.1: Released on 15 Jun 2010

Added workaround for a linker problem that could occur in C++ Builder 2009 and 2010.
Bugfix: Setting TJamSystemShellView.ViewStyle to another value than its default value in the Object Inspector at design time produced an unhandled exception when running the application.
Bugfix: Double clicking on a file in a ZIP-file did not open the file.
A few minor tweaks have been incorporated.

V7.1: Released on 25 May 2010

Added property AutoSizeColumn to JamShellList and JamFileList which adjusts the defined column to fill the remaining horizontal space so that no scrollbar appears.
Added property JamPathEdit.Color which is mapped to the aggregated TEdit.Color.
Delphi Edition: Added event JamShellCombo.OnAddFolder which is triggered whenever an item is added to the box.
Delphi Edition: Added property TJamComboItem.Path which contains the file system path of the item. It will be empty for non file system objects.
Added property Paths to TFileList that returns a list of paths of all file system objects contained in the list.
ZIP files now open within the JamShellList if they are double clicked.
The values JamShellList.Path and TJamShellTree.SelectedFolder are no longer stored in the DFM file if the SpecialFolder property has a value that is not SF_FILESYSTEMFOLDER. This ensures that special folder paths are evaluated using Windows API functions.
The context menu of the JamFileList has been improved, especially on Windows 7, if more than one file is selected.
The column header of the JamDriveList now shows a context menu that allows to activate or deactivate columns.
If the shell context menu cannot be queried from the system and a context menu of the application was given for merging (assigned to the PopupMenu property), then this popup menu is shown now.
Resorting has been improved after a folder in the JamShellList has been renamed.
Bugfix: The check state of items in the JamShellList could be returned incorrectly if the item was not yet visible (not scrolled into view).
Bugfix: In Delphi 2009/2010 the TJamFileList lost its contents if the ViewStyle property was changed.
Bugfix: A potential memory leak has been fixed when dropping files to JamshellTree.
Bugfix: Dependent on other properties' values, the font color set at design time was not used at runtime.
Bugfix: If non file system objects are dropped from applications that supply the file name only as ANSI String, then the file names are now also extracted correctly in Delphi 2009/2010.
Several minor improvements have been incorporated.
The support for C++ Builder 6 has been dropped.

V7.0.4: Released on 21 Jan 2010

The JamFileList and JamShellList now toggle the checkboxes of all selected items if the space bar is hit or the checkbox of one selected item is clicked.
If a file was dropped from Outlook, the file name is now supplied in the OnOperation event.
Added SF_PROGRAM_FILESX86, SF_PROGRAM_FILES_COMMONX86, SF_SYSTEMX86 to TJamShellFolder enumeration.
Now catching EExternal exceptions when the Explorer context menu is displayed.
The default value of JamSearchOptions.UseFullPathWhenComparing is now False
Improved paint position of thumbnail in JamThumbnailImage control.
The path that is suggested by the installer as default has been changed
ActiveX Edition: If threads were still active, the termination of the application hosting ShellBrowser ActiveX controls could take several seconds. This has been improved.

V7.0.3: Released on 23 Nov 2009

Now preventing a floppy seek noise that occurred in previous releases of V7 if "My Computer" has been enumerated on a Windows Vista or Windows 7 system.
Delphi Edition: Now triggering the OnContextPopup event before showing the Shell context menu.
Renamed TJamSelectionState.ssNone to ssDisabled, because this name fits better and solves a name collision with TScrollStyle.ssNone
Bugfix (ActiveX / Delphi 2009 / Delphi 2010): If JamShellList.ViewStyle has been changed while a virtual folder was displayed (e.g. a subfolder in a ZIP file or the new libraries of Windows 7) the displayed folder was resetted to "My Computer".
Bugfix: For files that no longer existed the JamFileList showed the full path also in the second column.
Several minor improvements and a few minor bug fixes have been incorporated.

V7.0.2: Released on 16 Oct 2009

JamFileList: If the Details property is turned off, the first column now shows the full path of the file.
The property Gridlines is now published for JamShellList and JamFileList control.
Bugfix: The setting of the UseSystemStyle property was not always applied correctly, dependent on the order in which the other properties were assigned.
Bugfix - JamShellList: Switching from vsIcon to vsReport view style produced an empty view due to missing columns.
Bugfix: Under Windows Vista and Windows 7 items could disappear from the JamShelList when SmartRefresh() was called if it was in vsReport mode but not sorted by the first column.
Bugfix: Occasionally the selected icon in the JamShellTree was not set correctly.
Bugfix: The JamFileList now supports again dragging of multiple files correctly.
A few minor improvements and fixes have been incorporated.

V7.0.1: Released on 15 Sep 2009

Bugfix: It could have happened that the new default background context menu was executed although it was not assigned.
Several minor improvements and a few minor bug fixes have been incorporated.

V7.0: Released on 10 Sep 2009

Since there are now with Delphi 2010 two Unicode enabled Delphi versions available, we decided to remove the dependency on the TMS Unicode controls from V7 of the ShellBrowser components. We received many requests from customers who didn't want to use TMS Unicode but were forced to do so because of this dependency. We also removed the support for Windows 9x from V7 of the ShellBrowser components. These changes will make the code much easier to maintain and to test and last but not least faster and smaller. For those who still want Unicode support in older Delphi versions or still want to support Windows 9x: ShellBrowser V6 will stay available for existing customers in our customer's area and critical bugs will still be fixed.
Added new properties ShowExtraLargeIcons and ShowJumboIcons to the JamShellList and JamFileList, which allows the user to switch the size of the icons in ViewStyle vsIcon. Jumbo Icons are only available under Windows Vista and later.
Added new property Checked to the JamShellListItem, JamShellTreeNode and JamFileListItem, which makes it easier to check an item or a node, it will than also be added to the JamShellLink.JamSelectionList.
The JamShellCombo now evaluates environment variables like %TEMP% entered in their address bar, similar to the Windows Explorer.
Added a background context menu to the JamShellList. This will be displayed if no background context menu is assigned to the BackgroundPopupMenu property of the JamShellList. It implements a subset of the Windows Explorer context menu.
The performance when listing the recycle bin in the JamShellList has been improved.
Bugfix: The OnMouseEnter and OnMouseLeave events will now be fired correctly in the ActiveX version.
Bugfix: If the JamSelectionList has been cleared, it could happen that the checkboxes in a JamShellTree have not been entirely reset.
Several minor improvements and a few minor bug fixes have been incorporated.