home *** CD-ROM | disk | FTP | other *** search
/ Windows Shareware 500 (First Edition) / disk2.img / FILECMDR / FILECMDR.MA$ / filecmdr.ma_
Text File  |  1992-08-26  |  17KB  |  786 lines
  1.  
  2.  
  3.  
  4.  
  5.                                               File Commander User's Guide
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.                                                   Wilson WindowWare, Inc.
  43.                                           2701 California Ave SW  ste 212
  44.                                                         Seattle, WA 98116
  45.  
  46.  
  47.                                                  Orders:   (800) 762-8383
  48.                                                  Support:  (206) 937-9335
  49.                                                       Fax: (206) 935-7129
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.                         Copyright (c) 1992 by Morrie Wilson.
  57.                                 All rights reserved.
  58.  
  59.  
  60.  
  61.  
  62.         No part of this manual may be reproduced or transmitted in any
  63.         form or by any means, electronic or mechanical, including
  64.         photocopying and recording, for any purpose without the express
  65.         written permission of Wilson WindowWare, Inc.  Information in
  66.         this document is subject to change without notice and does not
  67.         represent a commitment by Wilson WindowWare, Inc.
  68.  
  69.  
  70.  
  71.         The software described herein is furnished under a license
  72.         agreement.  It is against the law to copy this software under any
  73.         circumstances except as provided by the license agreement.
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.         U.S. Government Restricted Rights
  85.         Use, duplication, or disclosure by the Government is subject to
  86.         restrictions as set forth in subdivision (b)(3)(ii) of the Rights
  87.         in Technical Data and Computer Software clause at 252.227-7013.
  88.         Contractor/manufacturer is Wilson WindowWare, Inc./2701 California
  89.         Ave SW /ste 212/Seattle, WA 98116
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.         Trademarks
  97.         Microsoft and MS-DOS are registered trademarks of Microsoft
  98.         Corporation.
  99.         Windows, Word for Windows, Excel, and File Manager are trademarks
  100.         of Microsoft Corporation.
  101.  
  102.         WinBatch, Command Post, and File Commander are trademarks of Wilson
  103.         WindowWare, Inc.
  104.  
  105.  
  106.  
  107.                                                                           ii
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.                                       CONTENTS
  116.  
  117.  
  118.         CONTENTS                           iii
  119.  
  120.         INTRODUCTION                         v
  121.            System Requirements               v
  122.            About This Manual                vi
  123.            Notational Conventions           vi
  124.            Acknowledgements                 vi
  125.  
  126.         GETTING STARTED                      1
  127.  
  128.         USING FILE COMMANDER                 3
  129.            Installation                      3
  130.              Add-On Limitations              3
  131.              Menu Files                      4
  132.              Menu Titles                     5
  133.            Restrictions                      5
  134.  
  135.         FILE COMMANDER FUNCTIONS             7
  136.            Introduction                      7
  137.            Function List                     7
  138.            CurrentPath                       8
  139.            DirExist                          9
  140.            MsgTextGet                       10
  141.            Refresh                          11
  142.  
  143.  
  144.  
  145.  
  146.  
  147.  
  148.  
  149.  
  150.  
  151.  
  152.  
  153.  
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.                                                                          iii
  166.  
  167.                                                                 INTRODUCTION
  168.  
  169.  
  170.  
  171.  
  172.  
  173.                                     INTRODUCTION
  174.  
  175.         File Commander is an add-on for the Windows File Manager, which
  176.         allows you to add your own custom menu items to the normal File
  177.         Manager menu.
  178.  
  179.  
  180.  
  181.         With almost two hundred functions and commands, File Commander can:
  182.  
  183.  
  184.            .  Run Windows and DOS programs.
  185.  
  186.            .  Send keystrokes directly to applications.
  187.  
  188.            .  Rearrange, resize, hide, and close windows.
  189.  
  190.            .  Run programs either concurrently or sequentially.
  191.  
  192.            .  Display information to the user in various formats.
  193.  
  194.            .  Prompt the user for any needed input.
  195.  
  196.            .  Present scrollable file and directory lists.
  197.  
  198.            .  Copy, move, delete, and rename files.
  199.  
  200.            .  Read and write files directly.
  201.  
  202.            .  Copy text to and from the Clipboard.
  203.  
  204.            .  Perform string and arithmetic operations.
  205.  
  206.            .  Make branching decisions based upon numerous factors.
  207.  
  208.  
  209.         And much, much more.
  210.  
  211.  
  212.         System Requirements
  213.         File Commander requires an IBM PC or compatible with a minimum of
  214.         2MB memory running Microsoft Windows version 3.1 or higher.
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.                                                                            v
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.         About This Manual
  234.         File Commander is an application which uses our Windows Interface
  235.         Language (WIL).  Please refer to the WIL Reference Manual for an
  236.         introduction to WIL, as well as for complete documentation of the
  237.         many functions available in WIL (and therefore, in File Commander).
  238.  
  239.         This User's Guide includes only topics and functions which are
  240.         exclusive to File Commander or which behave differently in File
  241.         Commander, as well as additions and changes that have been made
  242.         since the WIL Reference Manual went to press.
  243.  
  244.         Note: File Commander is a menu file based implementation of WIL.
  245.  
  246.  
  247.  
  248.  
  249.         Notational Conventions
  250.         Throughout this manual, we use the following conventions to
  251.         distinguish elements of text:
  252.  
  253.         ALL-CAPS
  254.            Used for filenames.
  255.  
  256.         Boldface
  257.            Used for important points, programs, function names, and parts of
  258.            syntax that must appear as shown.
  259.  
  260.         system
  261.            Used for items in menus and dialogs, as they appear to the user.
  262.  
  263.         Small fixed-width
  264.            Used for WIL sample code.
  265.  
  266.         Italics
  267.            Used for emphasis, and to liven up the documentation just a bit.
  268.  
  269.  
  270.  
  271.  
  272.         Acknowledgements
  273.         File Commander software developed by Morrie Wilson.
  274.  
  275.         Documentation written by Richard Merit.
  276.  
  277.  
  278.  
  279.  
  280.  
  281.                                                                           vi
  282.  
  283.  
  284.  
  285.  
  286.  
  287.  
  288.  
  289.                                       GETTING
  290.                                       STARTED
  291.  
  292.         File Commander is quite easy to install.  You will find an
  293.         appropriate diskette in your File Commander package.  Take the
  294.         diskette and insert it into your floppy drive.  The File Commander
  295.         installation program is itself a Windows application, so make sure
  296.         Windows is running.
  297.  
  298.         Start (or activate) File Manager, and click on the A: or B: drive
  299.         icon, depending on which floppy drive contains the File Commander
  300.         diskette.  A directory tree will appear for the File Commander
  301.         diskette.  You should see a root directory icon.  Double-click on
  302.         this icon and a list of filenames will appear.  Find the filename
  303.         WSETUP.EXE and double-click on it.  Follow whatever instructions
  304.         WSETUP gives you.
  305.  
  306.         WSETUP will copy or create the necessary files in a directory of
  307.         your choice.
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.                                                                            1
  340.  
  341.  
  342.                                                                        USING
  343.                                                               FILE COMMANDER
  344.  
  345.  
  346.  
  347.  
  348.  
  349.                                        USING
  350.                                    FILE COMMANDER
  351.  
  352.  
  353.  
  354.  
  355.         Installation
  356.         File Commander is not run as a normal executable program.  Rather,
  357.         as an extension to File Manager, it is loaded automatically when
  358.         File Manager starts up.  The WSETUP program, which is used to
  359.         install File Commander, adds or modifies two sections to your
  360.         WINFILE.INI file: [AddOns] and [FileCmdr].  The settings in these
  361.         sections determine the start-up defaults for File Commander.
  362.  
  363.  
  364.  
  365.         Add-On Limitations
  366.         File Commander allows you to attach from one to four top-level menu
  367.         items to File Manager, each of which is considered to be a separate
  368.         File Manager add-on (and each of which is represented by a
  369.         combination of a DLL file and a menu file).  By default, WSETUP
  370.         configures File Commander to add four add-ons.  However, you may
  371.         want to use a smaller number, since File Manager allows a maximum
  372.         of only four or five add-ons, and you may have other add-ons which
  373.         you want to use in addition to File Commander.  You can reduce the
  374.         number of add-ons which File Commander adds by editing the [AddOns]
  375.         section of WINFILE.INI.  The default installation adds four add-
  376.         ons, as follows:
  377.  
  378.            [AddOns]
  379.            WWWFC1=WWWFC1.DLL
  380.            WWWFC2=WWWFC2.DLL
  381.            WWWFC3=WWWFC3.DLL
  382.            WWWFC4=WWWFC4.DLL
  383.  
  384.  
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.  
  392.  
  393.  
  394.  
  395.                                                                            3
  396.  
  397.  
  398.                                                                        USING
  399.                                                               FILE COMMANDER
  400.  
  401.  
  402.  
  403.  
  404.  
  405.  
  406.         (Your [AddOns] section will contain additional lines if you have
  407.         add-ons from any other products already installed).  To reduce the
  408.         number of File Commander add-ons to three, simply delete the
  409.         reference to add-on #4 (WWWFC4.DLL):
  410.  
  411.            [AddOns]
  412.            WWWFC1=WWWFC1.DLL
  413.            WWWFC2=WWWFC2.DLL
  414.            WWWFC3=WWWFC3.DLL
  415.  
  416.  
  417.  
  418.         You can likewise remove add-on #3 (WWWFC3.DLL) and #2 (WWWFC2.DLL).
  419.  
  420.         Note: Early versions of Windows 3.1 only support four add-on DLL's.
  421.         It is expected that future versions will support five add-on DLL's.
  422.         Please refer to the File Commander README.TXT file for any updated
  423.         information on this.
  424.  
  425.  
  426.  
  427.  
  428.         Menu Files
  429.         Each File Commander add-on DLL has an associated menu file, which
  430.         defines the menu structure of that add-on.  The names of these menu
  431.         files are specified in the [FileCmdr] section of WINFILE.INI, as
  432.         follows:
  433.  
  434.            MenuFile1=WWWFC1.MNU
  435.            MenuFile2=WWWFC2.MNU
  436.            MenuFile3=WWWFC3.MNU
  437.            MenuFile4=WWWFC4.MNU
  438.  
  439.  
  440.  
  441.         Each of these menu files is independent, and is edited individually
  442.         (refer to the WIL Reference Manual for information on menu file
  443.         structure).  Each menu file can contain a maximum of 99 menu items.
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.                                                                            4
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.         Menu Titles
  463.         The titles of each of the top-level menu items are determined by
  464.         the following settings in the [FileCmdr] section of WINFILE.INI:
  465.  
  466.            MenuTitle1=
  467.            MenuTitle2=
  468.            MenuTitle3=
  469.            MenuTitle4=
  470.  
  471.  
  472.  
  473.         "MenuTitle1" is the title of the menu defined by "MenuFile1", etc.
  474.  
  475.  
  476.  
  477.  
  478.         Restrictions
  479.         File Commander does not support the use of menu hotkeys, as
  480.         discussed in the WIL Reference Manual.
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.                                                                            5
  508.  
  509.  
  510.                                                               FILE COMMANDER
  511.                                                                    FUNCTIONS
  512.  
  513.  
  514.  
  515.  
  516.  
  517.                                    FILE COMMANDER
  518.                                      FUNCTIONS
  519.  
  520.  
  521.  
  522.  
  523.         Introduction
  524.         This section includes only those additional File Commander
  525.         functions which do not appear in the WIL Reference Manual.  The WIL
  526.         Reference Manual is your primary reference to the functions
  527.         available in File Commander.
  528.  
  529.         Note: The functions listed under the See Also headings may be
  530.         documented either in this User's Guide or in the WIL Reference
  531.         Manual.
  532.  
  533.  
  534.  
  535.  
  536.         Function List
  537.  
  538.  
  539.         CurrentPath ( )
  540.            Returns path of the selected filename.
  541.  
  542.         DirExist ([d:]path)
  543.            Determines if a directory exists.
  544.  
  545.         MsgTextGet (window-name)
  546.            Returns the contents of a Windows message box.
  547.  
  548.         Refresh (request#)
  549.            Updates file window display.
  550.  
  551.  
  552.  
  553.  
  554.  
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.                                                                            7
  564.  
  565.  
  566.                                                                  CURRENTPATH
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.         CurrentPath
  576.         Returns path of the selected filename.
  577.  
  578.  
  579.         Syntax:
  580.          CurrentPath ( )
  581.  
  582.         Parameters:
  583.          (none)
  584.  
  585.         Returns:
  586.          (s)          path of currently-selected file.
  587.  
  588.         When a WIL menu shell displays the files in the current directory,
  589.         one of them may be "selected."  This function returns the drive and
  590.         path of that file, if any.
  591.  
  592.         This is different than a "highlighted" file.  When a file is
  593.         highlighted, it shows up in inverse video (usually white-on-black).
  594.         To find the filenames that are highlighted, see FileItemize.
  595.  
  596.  
  597.         Example:
  598.          myfile = StrCat(CurrentPath(), CurrentFile())
  599.          DirChange("c:\word")
  600.          Run("winword.exe", myfile)
  601.  
  602.  
  603.         See Also:
  604.            CurrentFile, DirGet, FilePath
  605.  
  606.  
  607.  
  608.  
  609.  
  610.  
  611.  
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.                                                                            8
  620.  
  621.  
  622.                                                                     DIREXIST
  623.  
  624.  
  625.  
  626.  
  627.  
  628.  
  629.  
  630.  
  631.         DirExist
  632.         Determines if a directory exists.
  633.  
  634.  
  635.         Syntax:
  636.          DirExist ([d:]path)
  637.  
  638.         Parameters:
  639.          (s) [d:]path directory name, with optional drive.
  640.  
  641.         Returns:
  642.          (i)          @TRUE if the directory exists;
  643.                       @FALSE if it doesn't exist.
  644.  
  645.         You can use this function to determine whether a specified drive is
  646.         valid by checking for the existence of the root directory on that
  647.         drive.
  648.  
  649.  
  650.         Examples:
  651.          wpdir = "c:\wp"
  652.          If DirExist(wpdir) == @FALSE Then DirMake(wpdir)
  653.          DirChange(wpdir)
  654.  
  655.          :top
  656.          drive = AskLine("Run Excel", "Enter a drive letter", "")
  657.          If drive == "" Then Exit
  658.          drive = StrSub(drive, 1, 1)
  659.          If DirExist("%drive%:\") == @FALSE Then Goto top
  660.          NetAddCon("\\userapps\excel", "", drive)
  661.  
  662.  
  663.         See Also:
  664.            DirChange, DirMake, DirRemove, DirRename, FileExist
  665.  
  666.  
  667.  
  668.  
  669.  
  670.  
  671.  
  672.  
  673.  
  674.  
  675.                                                                            9
  676.  
  677.  
  678.                                                                   MSGTEXTGET
  679.  
  680.  
  681.  
  682.  
  683.  
  684.  
  685.  
  686.         MsgTextGet
  687.         Returns the contents of a Windows message box.
  688.  
  689.  
  690.         Syntax:
  691.          MsgTextGet (window-name)
  692.  
  693.         Parameters:
  694.          (s) window-name    full title of the message box window.
  695.  
  696.         Returns:
  697.          (s)          contents of the message box.
  698.  
  699.  
  700.         This function returns the text contents of a standard Windows
  701.         message box.  "Window-name" must be the full title of the message
  702.         box window, and is case-sensitive.
  703.  
  704.         Note: This function will not work with the types of message boxes
  705.         created by most WIL functions, since they are not standard Windows
  706.         message boxes.
  707.  
  708.  
  709.         Example:
  710.          msg = MsgTextGet("Microsoft Word")
  711.          If msg == "Search text not found" Then SendKey("~")
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.                                                                           10
  731.  
  732.  
  733.                                                                      REFRESH
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.         Refresh
  742.         Updates file window display.
  743.  
  744.  
  745.         Syntax:
  746.          Refresh (request#)
  747.  
  748.         Parameters:
  749.          (i) request# see below.
  750.  
  751.         Returns:
  752.          (i)          always 1.
  753.  
  754.         This function updates the files being displayed in the File Manager
  755.         window, as well as the drive icons that are displayed.  It is
  756.         useful after running an application (such as a DOS program) which
  757.         creates, deletes, or renames a file in the directory being viewed,
  758.         or connects to (or disconnects from) a network server, and you wish
  759.         the changes to be reflected in the File Manager window.
  760.  
  761.         Specifying a request# of 0 causes only the active window to be
  762.         updated, and specifying a request# of 1 causes all File Manager
  763.         windows to be updated.
  764.  
  765.         Note:  This command does not take effect until the WIL program has
  766.         completed, regardless of where the command may appear in the
  767.         program.
  768.  
  769.  
  770.         Example:
  771.          Run("pkunzip.exe", CurrentFile())
  772.          Refresh(0)
  773.  
  774.  
  775.         See Also:
  776.            Reload
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.                                                                           11
  786.