
			  Windows Filename Completion

			   Copyright Jason Hood 2005

			     Freeware. Version 1.13


    ===========
    Description
    ===========

    Windows Filename Completion (wfNameC) is a utility for  keyboard  users.
    It	allows	filenames to be completed by pressing a key.  Three keys are
    available.	Two will cycle through all names (forwards  and  backwards);
    the  third	will display a list.  These keys can be used interchangeably
    (the list can be displayed during a cycle; the cycle will continue after
    a list selection).


    ============
    Requirements
    ============

    32-bit Windows.


    ============
    Installation
    ============

    Unzip to a directory of your choice.
    Run "wfNameC.exe".
    Select the desired hotkeys and options.
    Press OK.

    To uninstall, uncheck the "Start with Windows" option  and  exit.   Then
    simply  delete the directory you placed it in.  There is also a registry
    entry at "HKEY_CURRENT_USER\Software\Adoxa\wfNameC" that you might  like
    to remove.


    =====
    Usage
    =====

    When you are asked to enter a filename, it is  no  longer  necessary  to
    type  in  every character, or use the Browse dialog.  Instead, just type
    the first couple of characters and press one of the new hotkeys.

    The cycle and back hotkeys will automatically supply the common part  of
    every  matching  filename.	 When  pressed	again,	it will cycle either
    forwards ("Cycle") or backwards ("Back") through all  the  names.   Once
    every  name  has  been displayed, it will again display the common part.
    For example, if the directory contains the files:

        makefile
        wfNameC.c
        wfNameC.exe
        wfNameC.h
        wfNameC.ico
        wfNameC.rc
        wfNameC.txt

    then typing "w" and pressing the cycle  hotkey  will  enter  "wfnamec.".
    Subsequent presses will then enter "wfNameC.c", "wfNameC.exe", and so on
    until "wfNameC.txt", then back to "wfnamec.".  Note that if  the  common
    part  has already been entered, nothing will happen (it completes what's
    already there).  So if you type nothing, the first press of  the  hotkey
    completes  nothing	(since the above names have nothing in common), then
    the second will display "makefile".  If  you  check  the  option  "Cycle
    immediately",  the  common part will not be completed.  Instead, it will
    display the first name straight away, then the second, and so on,  until
    going back to what you originally typed.

    The list hotkey will display a list of matching filenames, entering  the
    common portion.  Additional keys will be added after the common portion,
    reducing the displayed names.  For example, typing "w" and then pressing
    the  list  hotkey  will  enter  "wfnamec."  and display all those files.
    Typing "t" will  reduce  the  list  to  "wfNameC.txt".   Backspace  will
    restore  it  to  the  complete  list.   Backspace again, or Escape, will
    cancel the list and restore what you typed (the "w").

    In both cases, if only one name matches it	will  complete	immediately.
    If	no  names  match,  the	default  beep is sounded.  If a directory is
    selected from the list, a new completion will be started with the  files
    in	that  directory,  otherwise the cycle or list will continue with the
    original entry.

    The hotkeys can be used in the list (an alternative  to  Enter).   Using
    the  list  hotkey  on  a  directory  will also display the list for that
    directory.

    Wildcards can be entered explicitly.  For example, if you  just  want  a
    list of executable files, you can type "*.exe".  In this case, the cycle
    will always start immediately.

    Note that it is usually necessary to enter a complete  path  (ie.  drive
    and  root  directory).   If  you  are  using Explorer-style Open or Save
    dialogs, though, the displayed folder will be recognized as the  current
    directory.	The initial completion path will be used as the current dir-
    ectory for the next completion, so	if  wfNameC  doesn't  recognise  the
    displayed  folder (as with the Office Open/Save dialogs), it should only
    be necessary to enter the complete path once.

    The filename to be completed stops at the current  cursor  position.  It
    starts  either  at	the  first  unterminated quote, the beginning of the
    line, the first word before the cursor to have a drive specifier, or the
    first  space  before  the cursor.  A filename with an opening quote will
    not have a closing quote automatically appended.  If you have not  spec-
    ified  a complete path, it might be necessary to add an opening quote to
    continue cycling names that have spaces.

    If you choose to hide the tray icon, simply run "wfNameC.exe"  again  to
    bring up the settings dialog.


    ===============
    Version History
    ===============

    1.13 - 1 December, 2005:

    * fixed occasional crash when used without a valid edit field.

    1.12 - 7 July, 2004:

    * fixed some problems with getting the folder from the Open/Save dialog.

    1.11 - 28 June, 2004:

    * fixed bug not closing find handle (prevented XP from deleting dir.);
    * added cycle backwards hotkey (default is Ctrl+Shift+~, changing list
      to Ctrl+Alt+~).

    1.10 - 13 to 25 January, 2003:

    * use the system link color in the About box;
    * terminate the filename at the  current  cursor  position,  instead  of
      using a quote;
    * allow slashes ("/"), but replace them with backslashes ("\");
    * allow  filenames	within the line, not just at the beginning (so it is
      possible to complete parameters of commands,  not  just  the  commands
      themselves);
    * work with multi-line edit controls (that are not too big);
    * the current directory will be set to the initial path;
    * fixed a bug when the initial completion was empty.


    ===============
    Acknowledgments
    ===============

    Alex Vallat, who supplied me with his UAC source code.
    Jacob Navia, for LCC-Win32.


    =======
    Contact
    =======

    mailto:jadoxa@yahoo.com.au
    http://wfnamec.adoxa.cjb.net/

    Jason Hood
    11 Buckle Street
    North Rockhampton
    Qld 4701
    Australia


    ============
    Distribution
    ============

    The original zipfile can be freely distributed, by any means. However, I
    would  like  to  be  informed if it is placed on a CD-ROM (other than an
    archive compilation).  Modified versions may be distributed, as long  as
    the original zipfile is included (I would prefer to be contacted).


    =============================
    Jason Hood, 1 December, 2005.
