FoldersTree Installation

This document describes how to install FoldersTree control with three compilers:

• Microsoft^® Visual C++ 6.0 or above (also known as MSVC++);
• Borland^®  C++ 5 or above (both the free C++ compiler and C++ Builder);
• GNU Compiler Collection (GCC) 2.95 or above.

The current version of FoldersTree is distributed in the form of a DLL (fldtree.dll). For linking with the DLL you need an import library (fldtree.lib). Because different compilers need different import libraries we don't ship the file fldtree.lib with FoldersTree DLL. Instead you need to make the import library yourself. It is simple:

Unpacking archive

Firstly you need to unpack the distribution archive (fldtree.zip). You can do it with most archivers (such as WinZip, WinRAR, ZipMagic and many others)... Well you already did this :-)

Making the Import Library

• Create a (temporary) directory.
• Copy to that directory the files fldtree.dll and fldtree.def from the FoldersTree distribution.
• Make sure that the command we will run in the next item of this list is included in your PATH environment variable. (Generally the installer of your compiler automatically add the directory with the command we need to PATH, but sometimes you may need to set the variable manually.)
• Execute the following command being in the temporary directory you created:
  • For Microsoft^® Visual C++:
    lib.exe /def:fldtree.def /machine:IX86
  • For Borland^® C++:
    implib.exe -c fldtree.lib fldtree.dll
  • For GNU Compiler Collection:
    dlltool.exe -l fldtree.lib -d fldtree.def -D fldtree.dll fldtree.dll

Now you have the file fldtree.lib, which is the import library you need for your compiler!

The Last Step

Copy the files fldtree.h, fldtree.dll and fldtree.lib to the appropriate directories accessible to your compiler. (See the documentation of your compiler about which directories are appropriate.)

Every time you'll link your program (which uses FoldersTree control), you need to link it with fldtree.lib you created. Do not attempt to link directly with fldtree.dll! Make sure that you distribute the file fldtree.dll with your program!

See the file doc\index.html in the FoldersTree distribution about FoldersTree API.