Future Technologies Directory TreeView Control

What is this:
=============
A great control which displays all paths existing on your drives (both fixed,
floppy, CD, etc.) like Windows Explorer does. If you want to add Explorer
look'n'feel for your applications then look for this control.

To use:
=======
Usage is very simple, just like any other controls we produce.
Drop it on a form and consider about the main property: "Directory". 
This is a BSTR which is updated with the selected directory in the tree view.

Read Directory whenever you want to know what the selected directory is.
Write Directory to change the selection to another directory.

Usage with Microsoft Visual C++ 5.0
===================================
For unknown reasons VC++ 5.0 ClassWizard refuses to import the Directory 
property when creating the class wrapper for the control. That must be
redefined manually. Hence, to use the control with VC++ 5.0, use
the .CPP and the .H file contained in VC50.ZIP distributed along with this
archive. I dunno about VC++ 6.0 (if Directory is not imported, use VC50.ZIP
as you would do with VC++ 6.0.


Methods you can use with this control
=====================================
WARNING: methods not mentioned here are for internal usage and end user
doesn't need to (and should not) use them.

WARNING 2: we assume the end user is using C/C++ for the below description.
Other languages way to do should be analogue.

============================================================================
BeginUpdate - lock the tree view window update while changing contents
              It somewhat speeds up operations like expanding or collapsing
              the tree, or updating it after directories insertion or 
              deletion.

============================================================================
EndUpdate   - this method must be *always* called after you have done custom
              processing after BeginUpdate. A sample could be:

    BeginUpdate();
        ... developer defined instructions...
    EndUpdate();

============================================================================
Set_Visible(WordBool) - this method hides or show the tree control.
    
Example:
    DirectoryTreeControl.Set_Visible(false);    // hides control
    DirectoryTreeControl.Set_Visible(true);    // shows control

============================================================================
Set_ReadOnStart(WordBool) - instruct the directory control to update paths
upon program start. When false, program load will be faster but directories
will be read on demand (for instance, when expanding or collapsing).
When true, program will initially take longer to load but no updates will be
performed on subsequent operations like 

============================================================================
Set_ReadOnly(WordBool) - this prevents user to editing directories. If you
have developed custom procedures to add, delete or rename directories and
you want to apply them to Directory TreeView control, make sure you call
this method with false. Ex: 
    DirectoryTreeControl.Set_ReadOnly(false);

============================================================================
Set_Drive(short) - select the specified drive. Value should be the
ordinal number of the drive you want to select. Ex:
    Set_Drive(65);   // set drive A

============================================================================
Set_Enabled(WordBool) - enable or disable control. Wehen false, the control
will be grayed and won't respond to user actions. Setting it to true
enables it back again.

============================================================================
WordBool AlphaSort() - this sort the directories in alphabetical order.
returns true upon success.

============================================================================
OLE_COLOR Get_Color() - returns current background color value

============================================================================
WordBool Get_Ctl3D() - returns whether the control is in 3d mode (Win95 look)
or not (old flat Win 3.1 look).

============================================================================
WordBool Get_Enabled() - returns true if control is enabled, false if not.

============================================================================
IFontDisp Get_Font() - returns current control font (default is MS Sans 
     Serif)

============================================================================
BSTR Get_InitialDirectory() - returns the initial directory the control has
been set to (see also Set_InitialDirectory() ). If no directory was initially
specified, it returns an empty string.

============================================================================
WordBool Get_ReadOnly() - returns read only control state


============================================================================
void FullCollapse() - causes the directory tree to Full collapse so that 
only parent drives are shown.

============================================================================
void FullExpand() - causes the directory tree to Full expand so that 
all directories are shown.

============================================================================
void ReLoad() - reloads the entire disks content and updates directories
tree by consequence. It should be called like so:

    BeginUpdate();
    Reload();
    EndUpdate();


Registration:
=============
This is an unregistered evaluation release. You are allowed to test it for
15 days then you must register or uninstall it. Registration price is
only US$ 19.95. The control may be registered online at our web page:

www.futurtechno.com

We accept money orders, checks, eurocheques (EEC only) and all major
credit cards (secure registration form available).

Upon registration you will get info from us as how to get the unlimited
release and you will get lifetime technical support as well as free access
to all future releases, if any.
