                        S H E L L B R O W S E R
                       =========================
                      2.1 for Delphi / C++ Builder


The ShellBrowser component set gives a Delphi programmer easy access to the
Win32 shell functionality. The TJamShellList, TJamShellTree and TJamShellCombo
components look and behave exactly like the common Explorer controls. The
TShellBrowser component provides an easy interface to the Windows shell. For
every object all components can show the explorer context menu, the properties
page, the correct item, etc. You can shuffle the explorer context menu with
your own Delphi popup menus. Also you can delete files correctly to the recycle
bin. So it is easy to add typical Win95 functionality to your existing
applications and you can build an Explorer like application with only a few
lines of code. Interesting sample projects and help file with a lot of example
code are included.


INSTALLATION
~~~~~~~~~~~~
After installing the package JamShell via Components|Install Packages in
the IDE, you will find a new tab "JAM Software" in the component palette,
which contains the shell components. Then you should have a look at the sample
applications included. 
Since Delphi doesn't add the path to new packages automatically to the search
path, you may need to add the path to the Lib folder of ShellBrowser in the
Environment Options of Delphi and C++ Builder. Please have a look at the file
Readme.txt in the Help directory to get information how to install the help
files of the ShellBrowser components.


BUGS AND LIMITATIONS
~~~~~~~~~~~~~~~~~~~~
* On some systems incorrect drag&drop cursors are shown.
Please report all bugs and problems you have to the E-Mail adress below.


COPYRIGHT
~~~~~~~~~
The TShellBrowser components are Shareware, that means you can try them and
distribute the complete archive. If you decide to use it, you must register.
Please look in the help file for detailed registration information.
                                      Copyriht 1997-1999 by Joachim Marder

CONTACT
~~~~~~~
JAM Software
Joachim Marder
Sdallee 35
54290 Trier
Germany

E-Mail  : marder@jam-software.com
WWW-Page: http://www.jam-software.com/delphi/
Fax     : +49-700-70707059


CHANGES
~~~~~~~
V2.1: Released 28 Jan 2000
* A bug in the TJamShellcombo is fixed, which sometimes caused error messages
* TJamShellCombo did not work correct with network folders
* Added the method IsSpecialObject to TShellBrowser
* TJamSystemImageList.GetIconFromExtension did not work correctly
* Better Dag&Drop support, e.g. for selected text
* Added method CreateDir to TJamShellList
* Added properties ShowHidden und FileSystemOnly (like they exist for the
  TJAmShellList)to the TJamShellTree. You can use them e.g. to hide the Recycled
  folders.
* Added AutoScroll feature to JamShellTree and TJamShellList
* Several minor bug fixes and improvements

V2.0 final: Released on 07 Jul 1999
* The TJamShellListView now has a property SelectedFiles, which is a TStringList
  with the currently selected folders and files, including their extension.
* The method ShowContextMenu of TJamShellList and TJamShellTree now returns the
  performed command, see help file for details.
* The mothod GetFolderIconNumber has been added to the TJamSystemImageList and
  returns the number of the standard folder icon.
* Some additional special folders have been added to the TJamShellFolder type.
* Some minor bug fixes

V2.0 beta 3: Released on 21 May 1999
* The new component TJamSystemImageList replaces the SmallImages and LargeImages
  properties of the TShellBrowser component. This change was necessary, because
  Delphi compiled the complete system image list into the executable. You will
  need to change your projects in the following way: Replace each ImageList
  assigned to a TShellBrowser component with a TSystemImageList and set the Images
  property of ListViews and TreeViews again.
* You can use the GetIndexFromExtension method of the TJamSystemImageList to
  get the icon number for a certain extension.
* Ole Drag&Drop is now implemented and seems to work fine. Use the property
  OleDragDrop to enable or disable it.
* The components had problems with the Drag & Dock operations of Delphi 4, this
  is fixed now.
* The TJamShellList component has a ShowHidden property now.
* A property ShellContextMenu lets you determine if the shell context menu
  should be displayed automatically when the user right clicks on a file or
  folder.
* A problem with the TJamShellCombo component is fixed now, sometimes the
  entries were not displayed in the correct order.

V2.0 beta 2: Released on 24 Mar 1999
* Help file is complete now.
* New methods GetColumnText and GetColumnInfo for the TShellBrowser component,
  which allow to get information what Explorer would display in a certain
  column for a certain file.
* Only those part of a TJamShellList is filled, which is visible to the user.
  The   rest is filled on demand. This speeds up filling of a TJamShellList.
* Like in the Windows Explorer, refreshes are delayed if the user selected a
  new folder using the keyboard. This makes use of the keyboard smarter in the
  TJamShellTree.
* Now runs with Delphi 4.00 - 4.03
* Several bug fixes and improvements
* Drag & Drop support is still missing (Sorry!), but will be present in the next
  release (Promised!)

V2.0 beta 1: Released 06 Feb 1999
* New visible Explorer like controls TJamShellTree, TJamShellList and
  TJamShellCombo were added
* New invisble component TJamShellLink which allow to synchronize the above
  components
* TShellBrowser now has a Filter property which allows to filter certain files
* TShellBrowser has an Event OnFileChanged which is fired when a change (adding,
  renaming or deleting of files) occured in the current directory.
* You can test with the IsSpecialFolder method, if the current folder is a
  special folder, e.g. the Control PAnel
* ShellBrowser now shows 'Rename' in the context menu and fires the event
  OnRename when this menu item is selected
* A lot of small but useful enhancements and bug fixes

V1.01: Released 03 Jul 98
* Support for Borland C++ Builder 3
* Problem fixed, that caused the Cut/Copy context menu items not to work on
  some Windows 95 versions.
* Problem fixed in the InvokeContextMenuCommand method, which sometimes 
  produced an error when used with mutiple files.
* Two small problems fixed in the Advanced sample

V1.0 (final release): Released 04 Jun 98
