This control displays the contents of a folder in a listview. When the user right clicks on a folder, it will automatically show the context menu. TJamShellList is derived from Delphi's TListView control, so you can use most of the properties and methods of the superclass with a TJamShellList.  

Use the Path property to get or set the current Folder, use the SpecialFolder property to set a special folder like the Control Panel. The Filter property can be used to filter certain files by extension. The FullRefresh method refreshes the displayed information. This control does not have a Font property, because it automatically uses the same font the Windows Explorer uses. Use the Popup property to merge your Delphi popup menus with the Shell Context menu. You can synchronize a TJamShellList with a TJamShellTree by using the ShellLink property.  

By default, a double click is handled by the component and it tries to perform the default action for the selected object. You can however use the OnDblClick event handler of the component to perform your own action. If you for example want to create a file open dialog, you want to handle double clicks on files by yourself, but double clicks on folders should be handled by the component. In this case, an event handler could look like this:

procedure TMyDialog.ShellListViewDblClick(Sender: TObject);
begin
  With ShellListView do begin
    if (SelectedFiles.Count>0) and FileExists(Path + SelectedFiles[0]) then
      //Process File like you want
      ShowMessage('Double click on file: ' + Path + SelectedFiles[0])
    else
      InvokeCommandOnSelected('default');
  end;//With
end;

To improve the speed in which a TJamShellList gets filled, we are using Windows API messages that fill the Subitems of a TJamShellListItem by demand only. As a result, Delphi's SubItems array appears to be empty. If you for some reason need to access the information in the SubItems array, you can use the OnAddItem event. Whenever this event is used, the SubItems array of each item gets filled when it is added (which results in a slower performance).  

Since the extensions of the file may be not displayed dependant on the user's settings it is not sufficient to use the TJamShellListItem. Caption property to determine the name of a file that corresponds to a TJamShellListItem. You should use GetFullPath and SelectedFiles instead.  

While this controls only mimics the right pane of the Windows Explorer, the TJamSystemShellView control hosts a true instance of the Windows Explorer's right pane and therefore looks an behaves exactly like the Windows Explorer on the target system.  

ShellControls