lsfileexplorer27.txt

TLsDirComboBox 及 TLsFileListView 是类似资源管理器 ( File Explorer ) 式样的加强版 TComboBox 构件

   - Choose Component|Install Component; ensure that 'Into existing package'
     tab is selected and the 'Package file name' is correct.
   - From Install Component Dialog, click Browse.
   - In the Unit FileName Dialog, navigate to your chosen directory and
     select LsFileExplorer27.pas, then click Open.
   - In the Install Component Dialog, click OK to compile and install the
     package.
   - Finally, right-click the Package Editor Diallog and save the package.


5. Notes on Usage
=================

5.1 Interconnecting components
------------------------------

If you use both TLsDirTree20 (or TLsDirTreeCombo27) and TLsFilelistView27
components in an application, they must be mutually connected through the use
of the TLsDirTree20's (or TLsDirTreeCombo27's) 'FileList' property and the
TLsFileListView25's 'DirTree' property (or 'DirTreeCombo' property if
TLsDirTreeCombo27 is used). Once they are interconnected, changes in one
component will be automatically reflected in the other component.

For example, the LsDirTree20 and LsFilelistView27 components in your application
are named as LsDirTree201 and LsFilelistView271 respectively. You can use Object
Inspector to set LsDirTree201's 'FileList' property to LsFilelistView271; likewise,
set LsFilelistView271's 'DirTree' property to LsDirTree201.


5.2 ShortCut Keys 
-----------------

     5.2.1 TLsDirTree20 and TLsDirTreeCombo27
     ==========================================================================     
     ShortCut Key(s)   Action
     ----------------  --------------------------------------------------------
     RightArrow        Expand the current selected node, if it is not expanded

     LeftArrow         Collapse the current selected node, if it is expanded

     F4                Display LsDirTreeView

     Esc               Close LsDirTreeView

     DownArrow         If current selected node is expanded, move to nextChild;
                       otherwise move to nextvisible node

     UpArrow           If current node is expanded, move to preChild; otherwise
                       move to prevVisible node

     Enter             Set the SelectedPath
     ==========================================================================

     5.2.2 TLsFilelistView27
     ==========================================================================
     ShortCut Key(s)   Action
     ----------------  --------------------------------------------------------
     Ctrl+C            Copy

     Ctrl+X            Cut

     Ctrl+V            Paste

     Ctrl+O            Open Files

     Ctrl+F            Quick view

     Ctrl+N            Create New Folder

     UpArrow           Move up

     DownArrow         Move down

     Delete            Send selected items to Recycle Bin

     Enter             Open (Files or Folders)

     BackSpace         Go to the parent folder

     F2                Rename file

     F3                Find Files

     F5                Refresh TLsFilelistView27
     ==========================================================================

5.3 Popup Context Menu
---------------------- 

     5.3.1 LsFileListView27Popup
     ================================================================
     Menu Name            Commands / Remarks
     ---------------      -------------------------------------------
     Open                 OpenItem
     View                 ViewFile
     ---------------
     Send To >            To open Send_To SubMenu, which contains:
                             Any Folder ... ,
                             Clipboard as Contents,
                             Clipboard as FileName,
                             Removable Disk(s), and
                             LinkFiles in \Windows\SendTo directory.
     ---------------
     Cut                  CutCopy(2)
     Copy                 CutCopy(0)
     Paste                Paste
     ---------------
     Rename File          RenameFile
     Delete               DeleteItems
     ---------------
     Attributes           FileAttr
     ---------------
     New Folder           NewFolder
     ================================================================
      
	
     5.3.2 LsDirTree20PopUp
     ================================================================
     Menu Name            Commands / Remarks
     ---------------      -------------------------------------------
     Add Folder           AddNewNode()  /Creates a new directory
     Rename Folder                      /Rename an existing directory
     Delete Folder        DeleteNode()  /Delete an existing directory 
     ---------------
     TreeSize             GetTreeSize() /Calculate the TreeSize from
                                         selected Directory
     ================================================================

     NB:- These file- and folder-management operations can easily be 
          linked to the application's main menu by adding few lines 
          of code.

5.4 If MultiSelect Property of TLsFilelistView27 is set to True, GetNextItem
    function can be used to find all selected items.


6. Limitation
=============

    Since these components are designed mainly for file management, Special
    DesktopFolders are not retrieved from the shell's name space and
    displayed in both components.

7 History
=========

 Version 2.70
-------------
    (B) LsDirTree20:

      - Add Function GetTreeSize.

      - Add Bipmaps to its PopupMenu.

    (A) LsFileListView27:

      - Added Property HideFileExt.

      - Added Property TimeFormatStr

      - Revised Procedure SetDateFormat to increse preset DateFormats
        and to provide customize option.

      - Added Bitmaps to the ColumnHeaders to indicate the sorted column
        and its direction of sorting.

      - Added Bitmaps to the its PopupMenu.

      - Added a 'Parent' folder at the top of filelist. Double-click on it,
        will go up one level (similar to Procedure OneLevelUp).

      - Enhancements to various functions and procedures.


 Version 2.60
 ------------
    - Added a Directory-TreeView component 'TLsDirTree20'.
    - Revised the KeyDown Event handler in TLsDirTreeCombo27.
    - Included icons in Send-To context menu (for D4 and D5).
    - Fixed bug that keep the drop-down LsDirTreeView on Top, when using
      Alt-Tab key to switch to other running application.

 Version 2.53
 ------------
    - Added PopupMenu and DblClickEnabled Properties to TLsFilelistView27.
    - Fixed 'Integer overflow or Floating point error' generated by Functions
      GetDiskSizze() or GetFreeDiskSize(). if the disk size or the logical
      partition size is larger than 4GB.
    - Fixed bug in Procedure TLsDirtreeCombo().
    - Compiler Directives modified in order to be compatible with Delphi 5.

 Version 2.52
 ------------
    - Added ShortCut keys to TLsDirTreeCombo27, and revised ShortCut keys
      in TLsFilelistView27 in order to conform with standard shortcuts
      used by Windows Explorer.
    - Added procedure FindFile to TLsFilelistView27.
    - In LsFilelistView27, Public Property FileName has been renamed to
      SelectedItem to reflect its function and FileAttrhas been declared
      as public.
    - Fixed bug that keep the drop-down LsDirTreeView on Top, even the
      application that owns TLsDirTreeCombo27, has been SentToBack.
    - Incorporated patches to TLsFilelistView27 to avoid possible AV errors.

 Version 2.51
 ------------
    - Fixed the undesired behavior of TLsDirTreeCombo27's dropdown
      treeview, if it's located on any component other than a TForm.

 Version 2.50
 ------------
    - TLsDirComboBox has been replaced by TLsDirTreeCombo27, in order to
      provide a hierarchical treeview of the file system.
    - Added SetColumnWidth() procedure to TLsFilelistView27.
    - Added ShowFolders property to TLsFilelistView27.
    - Added 'Anchors', 'BiDiMode' and 'Constraints' properties for Delphi
      version 4.xx.
    - Added Attributes to Context Menu
    - Send_To SubMenu has been revised.
    - Fixed bug in TLsFilelistView27's AddFiles() function.

 Version 2.00
 ------------
    - Use Windows API functions to perform copy, move, rename,
      delete, and other operations on files.
    - Added DriveFreeSpace, SelectedNumber and SelectedSize
      properties.
    - Also added an Popup Context Menu to TLsFilelistView27 for
      file operations.

 Version 1.20
 ------------
    - Added compiler directives to migrate both components to
      Delphi version 4.

 Version 1.10
 ------------
    - Fixed bugs in TLsFilelistView's Mask property to allow
      folders and filtered files to be displayed simultaneously.
    - Fixed bugs in TLsDirTreeCombo27's Click procedure.

 Version 1.00
 ------------
    - First development.

 Note :-   Latest patches in the source code are flagged by
           '//'+ minor version number.
           eg. //51 indicates changes made in version 2.51
-----------------------------------------------------------------------------