home *** CD-ROM | disk | FTP | other *** search
/ Boldly Go Collection / version40.iso / TS / 25D / TOY200.ZIP / TB2.TXT < prev    next >
Encoding:
Text File  |  1992-03-29  |  39.7 KB  |  881 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.                          ToyBox II (tm) User's Guide
  7.  
  8.                  Copyright 1991, 1992 Virtual Magic Software
  9.                              All Rights Reserved
  10.  
  11.  
  12.                             Virtual Magic Software
  13.                                  P.O. Box 615
  14.                            Fort Monmouth, NJ 07703
  15.  
  16.                            CompuServe:  70304,2045
  17.                               Prodigy:  CJKH33A
  18.  
  19.  
  20.  
  21.              Member of the Association of Shareware Professionals
  22.  
  23.  
  24.       INTRODUCTION...................................................2
  25.  
  26.       SYSTEM REQUIREMENTS............................................2
  27.  
  28.       REGISTRATION INFORMATION.......................................2
  29.  
  30.       INSTALLING TOYBOX II...........................................3
  31.  
  32.       STARTING TOYBOX II.............................................4
  33.  
  34.       MOVING AROUND IN TOYBOX II.....................................5
  35.  
  36.       ADDING A PROGRAM OR PAGE.......................................7
  37.  
  38.       REMOVING A PROGRAM OR PAGE.....................................9
  39.  
  40.       VIEWING/MODIFYING A PROGRAM OR PAGE...........................10
  41.  
  42.       SETTING HELPER WINDOW OPTIONS.................................10
  43.  
  44.       RUNNING AN INSTALLED PROGRAM..................................11
  45.  
  46.       PAINTER.......................................................11
  47.  
  48.       TIPS AND TECHNIQUES...........................................13
  49.  
  50.       COMPATIBILITY WITH EARLIER VERSIONS...........................15
  51.  
  52.       LICENSE AND WARRANTY..........................................15
  53.  
  54.       (Any last-minute additions/corrections to this User's Guide are 
  55.       listed in the README.TXT file on disk.)
  56.       
  57.       ============
  58.       INTRODUCTION
  59.       ============
  60.  
  61.       ToyBox II is a beautiful EGA/VGA graphical program manager 
  62.       designed for users of all ages.  It has the powerful features 
  63.       found in menu programs designed for adults, yet it can be safely 
  64.       and easily used by very young children.  ToyBox II uses large 3-D 
  65.       buttons with colorful, Microsoft Windows-compatible icons to 
  66.       represent your programs.  You or your child can run a program with 
  67.       a single keystroke or mouse click.  ToyBox II features multiple 
  68.       levels of menu pages which can hold several thousand programs (if 
  69.       you have that many), passwords, hotkeys, file pick-lists for 
  70.       easily adding programs, and a built-in icon editor.  ToyBox II 
  71.       requires no memory for its own use while it is running your 
  72.       programs.
  73.  
  74.  
  75.       ===================
  76.       SYSTEM REQUIREMENTS
  77.       ===================
  78.  
  79.       - MS-DOS 3.3 or later
  80.       - EGA/VGA
  81.       - 512K RAM
  82.       - Hard disk
  83.       - Microsoft-compatible Mouse (optional)
  84.  
  85.  
  86.       ========================
  87.       REGISTRATION INFORMATION
  88.       ========================
  89.  
  90.       We distribute ToyBox II as a shareware program, which means we 
  91.       allow you to try the program out before you pay for it.  If you 
  92.       find ToyBox II helpful and continue to use it, please send a $29 
  93.       (U.S.) registration fee to:
  94.  
  95.                             Virtual Magic Software
  96.                                  P.O. Box 615
  97.                            Fort Monmouth, NJ 07703
  98.  
  99.       We have included an order form (ORDER.TXT) on disk which you can 
  100.       print out if you desire.  If you choose not to use the order form 
  101.       to register, we need to know your name, address and desired disk 
  102.       size (3.5" or 5.25") to fulfill the order.  New Jersey residents 
  103.       must add 7% sales tax ($2.03 per copy).  We accept checks and 
  104.       money orders in U.S. funds drawn on U.S. banks.  We recommend you 
  105.       do not send cash.
  106.  
  107.       You can also order by credit card (VISA, MC, AmEx, Discover) from 
  108.       Public (software) Library by calling 800-242-4PsL (from overseas: 
  109.       713-524-6394) or by FAX (713-524-6398) or via CompuServe 
  110.  
  111.                                       2
  112.       (71355,470).  These numbers are for ordering only.  Virtual Magic 
  113.       Software can NOT be reached at these numbers.  For information 
  114.       about dealer pricing, volume discounts, site licensing, the status 
  115.       of shipment of the product, the latest version number or for 
  116.       technical information, or to discuss returns, contact Virtual 
  117.       Magic Software directly at the above mailing address.  You can 
  118.       also contact us on CompuServe (70304,2045) or Prodigy (CJKH33A).  
  119.       If you have any questions or comments about ToyBox II, even if you 
  120.       have not yet registered, please let us know.  It is through your 
  121.       comments and suggestions that we can make ToyBox II and future 
  122.       products even better.
  123.  
  124.       When you register, we'll send you a disk containing the latest 
  125.       version of ToyBox II, plus a collection of several hundred 
  126.       Microsoft Windows icons which you can use in ToyBox II.  
  127.       Registered users are entitled to free technical support for as 
  128.       long as we distribute the program.  Technical support will be 
  129.       provided via mail, CompuServe and Prodigy.  We'll also send you 
  130.       notice of upgrades and additional Virtual Magic Software products 
  131.       in the future. 
  132.  
  133.       This program is produced by a member of the Association of 
  134.       Shareware Professionals (ASP). ASP wants to make sure that the 
  135.       shareware principle works for you. If you are unable to resolve a 
  136.       shareware-related problem with an ASP member by contacting the 
  137.       member directly, ASP may be able to help. The ASP Ombudsman can 
  138.       help you resolve a dispute or problem with an ASP member, but does 
  139.       not provide technical support for members' products. Please write 
  140.       to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442 or 
  141.       send a CompuServe message via CompuServe Mail to ASP Ombudsman 
  142.       70007,3536.
  143.  
  144.       We encourage you to pass along a copy of ToyBox II to friends, 
  145.       associates, computer bulletin board systems, etc.  To ensure only 
  146.       unmodified versions are distributed, we ask that you distribute 
  147.       only the original compressed versions of the program (TOY200.EXE 
  148.       or TOY200.ZIP).  Please encourage others to register their copy if 
  149.       they find the program useful.
  150.  
  151.       For license and warranty information, please see the "License and 
  152.       Warranty" section at the end of this User's Guide.
  153.  
  154.  
  155.       ====================
  156.       INSTALLING TOYBOX II
  157.       ====================
  158.  
  159.       Normally ToyBox II is distributed as a single compressed file 
  160.       named either TOY200.EXE or TOY200.ZIP.  After you have 
  161.       decompressed this file, the following files which make up the 
  162.       complete ToyBox II program should be in a single directory on your 
  163.       hard disk:  TB2.BAT, TB2MAIN.EXE, SEE.EXE, TB2.INF, TB2-NU.INF, 
  164.       TB2-SI1.INF, TB2-SI2.INF, TB2.TXT, README.TXT, REGISTER.TXT, 
  165.  
  166.                                       3
  167.       ORDER.TXT, VENDOR.TXT, TOYBOX.ICO, eight internal files that end 
  168.       with a ".TBI" extension, and 30 sample icon files that end with a 
  169.       ".ICN" extension.  If you desire you can move the text (".TXT") 
  170.       files, the icon (".ICN") files, and TOYBOX.ICO to another 
  171.       directory, but the remainder of the files must not be deleted and 
  172.       must remain together in one directory.
  173.  
  174.       After you have installed some of your programs to run under ToyBox 
  175.       II, you may see some additional files with a ".$$$" extension.  Do 
  176.       not move or remove these files.  You should periodically back-up 
  177.       these files, as well as the ".INF" files, because they contain 
  178.       information on the programs you have installed in ToyBox II.
  179.  
  180.  
  181.       ==================
  182.       STARTING TOYBOX II
  183.       ==================
  184.  
  185.  
  186.       FROM THE DOS PROMPT
  187.  
  188.       First change to the directory containing the ToyBox II files (or 
  189.       ensure this directory is in the PATH statement in your 
  190.       AUTOEXEC.BAT file), then type "TB2".  ToyBox II automatically 
  191.       detects whether your system has an EGA or VGA compatible graphics 
  192.       card and switches to the highest graphics mode available.  It will 
  193.       also detect the presence of a mouse if you have a mouse driver 
  194.       installed.  If you have display problems, such as part of the main 
  195.       ToyBox II page not being visible, or the mouse pointer not 
  196.       displaying, you can force ToyBox II into the correct graphics mode 
  197.       by typing "TB2 E" for EGA or "TB2 V" for VGA.  If the mouse 
  198.       pointer still doesn't display, check to ensure you have a mouse 
  199.       driver properly installed.
  200.  
  201.       You can include the "TB2" command in your AUTOEXEC.BAT file to 
  202.       cause ToyBox II to automatically run when you turn on your 
  203.       computer.  If you aren't familiar with the purpose and contents of 
  204.       your AUTOEXEC.BAT file, we recommend you have someone help you 
  205.       with this.
  206.  
  207.  
  208.       FROM MICROSOFT WINDOWS
  209.  
  210.       We've included a special icon for Microsoft Windows named 
  211.       TOYBOX.ICO.  Follow instructions in the Microsoft Windows User's 
  212.       Guide to install and run ToyBox II as a DOS application under 
  213.       Windows.
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.                                       4
  222.       ==========================
  223.       MOVING AROUND IN TOYBOX II
  224.       ==========================
  225.  
  226.       When you open a window, such as the Helper window described later, 
  227.       it pops up on top of the current page and any windows that may 
  228.       already be displayed.  The top window is always the active window.  
  229.       You can only access objects (normally buttons and text boxes) that 
  230.       are in the active window.
  231.  
  232.  
  233.       SELECTING OBJECTS - MOUSE
  234.  
  235.       Move the mouse pointer to the desired object and click any of the 
  236.       mouse buttons.  To make it easier for small children, all mouse 
  237.       buttons have the same effect.
  238.  
  239.  
  240.       SELECTING OBJECTS - KEYBOARD
  241.  
  242.            1)  ALT Key:  Objects normally have an ALT key combination 
  243.       associated with them.  Most objects have one or more words under 
  244.       them or to the right of them describing the function of the button 
  245.       or box.  One of the letters in the words will have an underscore 
  246.       beneath it.  To select the object, hold down the ALT key and press 
  247.       the letter that is underscored.  For example, at the Helper 
  248.       window, to select the Add Program or Page button, hold down the 
  249.       ALT key and press "A".  Some buttons don't have text descriptions.  
  250.       The keys to select these buttons are:
  251.  
  252.                 - STOP Button:  ALT+S (only at title page)
  253.                 - Painter Button:  ALT+P (only at title page)
  254.                 - Information Button:  ALT+I (only at title page )
  255.                 - Close Window Button:  ESC
  256.                 - Helper Button:  ALT+H
  257.                 - OK Button:  ALT+O
  258.                 - Up-Arrow Button:  Page Up
  259.                 - Down-Arrow Button:  Page Down
  260.  
  261.            2)  Outline Cursor:  In some windows you must use the arrow 
  262.       keys on your keyboard to move from one object to the next.  A red 
  263.       outline cursor will indicate the current object.  To select the 
  264.       current object, press the ENTER key.  (If you have a mouse, this 
  265.       red outline cursor can be turned off if you intend to use only the 
  266.       mouse to select objects.  See "Setting Helper Window Options" 
  267.       below for instructions.)
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.                                       5
  277.       EDITING TEXT
  278.  
  279.       To add programs to ToyBox II, you must enter certain program 
  280.       information such as program title, filename, etc., into text 
  281.       boxes.  This section describes the general procedures for entering 
  282.       and editing text in text boxes.
  283.  
  284.            1)  Positioning the Text Cursor (Mouse):  Move the mouse 
  285.       pointer directly to the desired location within any of the text 
  286.       boxes in the active window and click one of the mouse buttons. The 
  287.       text cursor (a thin black vertical line) will move to the mouse 
  288.       pointer position.
  289.  
  290.            2)  Positioning the Text Cursor (KeyBoard):  Select the 
  291.       desired text box using the ALT key combinations or up and down 
  292.       arrow keys as described above.  Move around within the text box by 
  293.       using the left and right arrow keys.  Pressing the ENTER key will 
  294.       move the text cursor to the next text box.
  295.  
  296.            3)  Entering Text:  After positioning the text cursor, begin 
  297.       typing.  The text will be inserted at the text cursor location.  
  298.       ToyBox II will not allow you to enter more text than will fit 
  299.       inside the text box.
  300.  
  301.            4)  Deleting Text:  To delete a character to the right of the 
  302.       text cursor, press the DELETE key.  To delete a character to the 
  303.       left of the text cursor, press the BACKSPACE key.
  304.  
  305.  
  306.       CLOSING THE ACTIVE WINDOW OR PAGE
  307.  
  308.       Select the button in the upper left corner of the window/page with 
  309.       the mouse or press the ESCAPE key.
  310.  
  311.  
  312.       SAVING CHANGES
  313.  
  314.       After you have made configuration changes, such as adding a new 
  315.       program or disabling the STOP button, you must save these changes 
  316.       to disk.  Do this by selecting the OK button with the mouse or 
  317.       typing ALT+O.  If you decide you don't want the changes to be 
  318.       made, simply close the window without saving them.
  319.  
  320.  
  321.       MOVING BETWEEN PAGES
  322.  
  323.       Page buttons are treated identically to program buttons.  When you 
  324.       select a page button, the page is displayed.  To close the current 
  325.       page and return to the previous page, select the button in the 
  326.       upper left corner of the page or press the ESCAPE key.
  327.  
  328.  
  329.  
  330.  
  331.                                       6
  332.       ========================
  333.       ADDING A PROGRAM OR PAGE
  334.       ========================
  335.  
  336.       Open the Helper window by selecting the Helper button (the red 
  337.       cross) or by typing ALT+H.  Select the Add Program or Page button 
  338.       to open the Add Program or Page window.  This window contains the 
  339.       following objects:  
  340.  
  341.            1)  Files Button:  Select this button to open a window 
  342.       containing a list of files and directories on the current drive.  
  343.       Selecting a file from the list will automatically fill in the Path 
  344.       and Program text boxes.  Directories are indicated by a backslash 
  345.       ("\") at the end of the name.  Selecting a directory will cause 
  346.       the files for that directory to be displayed.  Selecting the "..\" 
  347.       entry will display the files of the parent directory of whatever 
  348.       directory you are currently in.  If the file list contains more 
  349.       than 16 files and directories, select the blue arrow buttons (or 
  350.       press the Page Up and Page Down keys) to display the next or 
  351.       previous 16 files.  ToyBox II can store 1024 directory/file names 
  352.       at a time.  If the current directory contains more than 1024 
  353.       directory/file names, ToyBox II will only display the first 1024.  
  354.       If you wish to add a program from a drive other than the current 
  355.       drive, you must enter the Path and Program information manually, 
  356.       as described below.
  357.  
  358.            2)  Icons Button:  This button works the same as the Files 
  359.       button except that it lists only ToyBox II icon (*.ICN) files.  
  360.       Use this to automatically fill in the Icon text box.
  361.  
  362.            3)  Copy Button:  Select this button to copy all program 
  363.       information currently in the Add Program or Page window to a 
  364.       temporary storage area in memory or "clipboard".  This information 
  365.       can later be pasted into another program being added or modified. 
  366.       The information remains in the clipboard until you: (1) overwrite 
  367.       it by using the Copy Button again, (2) run an application, or (3) 
  368.       exit ToyBox.  You cannot copy information if the Page button 
  369.       (discussed below) is set to "YES".
  370.  
  371.            4)  Paste Button:  Select this button to paste clipboard 
  372.       information to the program currently being added or modified.  
  373.       This is useful if you want to duplicate the same program button on 
  374.       more than one page.  
  375.  
  376.            5)  Button Title Text Box:  Enter a title for the program or 
  377.       page button.  This title will appear under the button.  If you are 
  378.       entering information for a page button, this will also be the 
  379.       title at the top of the page when it is opened.
  380.  
  381.            6)  Password Text Box:  You may enter an optional password 
  382.       which a user must enter to start the program or open the page.  
  383.       Passwords are always displayed on the screen as a series of 
  384.  
  385.  
  386.                                       7
  387.       asterisks.  This prevents someone looking over your shoulder from 
  388.       viewing the password on the screen.
  389.  
  390.            7)  Key Text Box:  You may enter an optional hotkey to be 
  391.       used to select the program or page.  You can use any printable 
  392.       character as a hotkey.  Upper and lower case letters are treated 
  393.       as the same letter.  Ensure that no two program/page buttons on 
  394.       the same page have the same hotkey, or ToyBox II will always 
  395.       select the first one it finds.  (Note these are not ALT key 
  396.       combinations.  If you enter "M" as the hot key to run a "Mickey 
  397.       Mouse" program, you will just have to press the "M" key to run the 
  398.       program, not ALT+M.)
  399.  
  400.            8)  Path Text Box:  Enter the drive/directory of the program.  
  401.       The easiest way to do this is to use the Files button, which will 
  402.       automatically fill in the correct information for both Path and 
  403.       Program text boxes.  Drive information is optional if the file is 
  404.       on the same drive as ToyBox II.  Directory information is optional 
  405.       if the file is in the same directory as ToyBox II or one of the 
  406.       directories listed in the DOS PATH statement.  The directory must 
  407.       begin with a backslash ("\").
  408.  
  409.                     Example:  C:\NATHAN\GAMES\
  410.  
  411.            9)  Program Text Box:  Enter the command to execute the 
  412.       program, plus any optional parameters.
  413.  
  414.                     Example:  MICKABC /E
  415.  
  416.            10)  Icon Text Box:  Enter the complete path and filename of 
  417.       the icon to be displayed on the button.  The easiest way to do 
  418.       this is to use the Icons button described above, which will 
  419.       automatically fill in the correct information.  Drive information 
  420.       is optional if the icon file is on the same drive as ToyBox II.  
  421.       Directory information is optional if the icon is in the same 
  422.       directory as ToyBox II.  The directory must begin with "\".  If 
  423.       you don't put an extension on the file name, ToyBox II will assume 
  424.       a ".ICN" extension.
  425.  
  426.                     Example:  C:\ICONS\ABC.ICN
  427.  
  428.       ToyBox II can only use icons in ToyBox format, normally 
  429.       represented by a ".ICN" extension.  These icons can be designed 
  430.       using the Painter icon editor built into ToyBox II.  A number of 
  431.       sample icons are included on the ToyBox II disk.  Some of these 
  432.       icons were designed from scratch with Painter.  Others are 
  433.       Microsoft Windows icons that were imported and converted by 
  434.       Painter.  For instructions on designing and importing icons, see 
  435.       the "Painter" section below. 
  436.  
  437.            11)  Page Button:  Setting this to "YES" indicates that 
  438.       information being entered is for a button that will open a page 
  439.       (submenu).  In this case, anything entered in the Program and Path 
  440.  
  441.                                       8
  442.       text boxes is ignored.  ToyBox II allows up to five levels of 
  443.       pages, which can hold thousands of programs.
  444.  
  445.            12)  Wait Button:  Setting this to "YES" causes ToyBox II to 
  446.       wait for ENTER to be pressed before redisplaying the current page 
  447.       after running the program.  This is useful if you need time to 
  448.       view the results of a program before ToyBox II reappears.
  449.  
  450.            13)  Variables Button:  Setting this to "YES" allows you to 
  451.       enter additional command line parameters at the time you run the 
  452.       program.  This is useful if you sometimes run the same program 
  453.       with different parameters.
  454.  
  455.            14)  Batch Button:  Set this to "YES" if the program is a 
  456.       batch file (a file with a ".BAT" extension), otherwise the program 
  457.       will not return to ToyBox II after it runs.  Another option for 
  458.       running a batch file (and actually the preferable option) if you 
  459.       are using MS-DOS 3.3 or later, is to leave this set to "NO" and 
  460.       precede the program name with the word "CALL" in the "Program" 
  461.       text box.
  462.  
  463.                     Example:  CALL MCGEE.BAT
  464.  
  465.            15)  OK Button:  After you have entered all necessary 
  466.       information, select the OK button with the mouse or press ALT+O to 
  467.       save the information to disk and close the window.  To close the 
  468.       window without adding the program/page, select the Close Window 
  469.       button in the upper left corner of the window or press the ESCAPE 
  470.       key.
  471.  
  472.  
  473.       ==========================
  474.       REMOVING A PROGRAM OR PAGE
  475.       ==========================
  476.  
  477.       Open the Helper window by selecting the Helper button (the red 
  478.       cross) or by pressing ALT+H.  Select the Remove Program or Page 
  479.       button to open the Remove Program or Page window.  This window 
  480.       lists the names of all the program/page buttons on the current 
  481.       page.  Select the program/page buttons you wish to remove, then 
  482.       select the OK button or press ALT+O.  To close the window without 
  483.       removing any programs, select the Close Window button with the 
  484.       mouse or press the ESCAPE key.  Removing a program from ToyBox II 
  485.       does not delete the program from disk.  It still exists and can be 
  486.       run normally from DOS or later added back to ToyBox II.  (If you 
  487.       try to remove a button for a page that itself has subpages, you 
  488.       will get a message saying "Pages containing subpages were not 
  489.       removed."  To remove the button in a case like this, you must 
  490.       first close the Helper window, open the page containing the 
  491.       subpages, and remove all the subpages individually.)
  492.  
  493.  
  494.  
  495.  
  496.                                       9
  497.       ===================================
  498.       VIEWING/MODIFYING A PROGRAM OR PAGE
  499.       ===================================
  500.  
  501.       Open the Helper window by selecting the Helper button (the red 
  502.       cross) or by pressing ALT+H.  Select the View/Modify Program or 
  503.       Page button to open the View/Modify window.  This window lists the 
  504.       names of all the program and page buttons on the current page.  
  505.       Select the program/page button you wish to view or modify.  A 
  506.       window titled View/Modify Program or Page will pop up containing 
  507.       the current information for that program/page button.  You can 
  508.       make any desired changes using the same techniques used in the Add 
  509.       Program or Page window.
  510.  
  511.  
  512.       =============================
  513.       SETTING HELPER WINDOW OPTIONS
  514.       =============================
  515.  
  516.       All pages have a Helper window which you can use to add, remove or 
  517.       view/modify program buttons on that page.  However, the following 
  518.       options are displayed only on the Helper window for the ToyBox II 
  519.       title page.
  520.  
  521.            1)  STOP Button:  Setting this to "NO" disables the STOP 
  522.       button on the ToyBox II title page.  To exit the program when the 
  523.       STOP button is disabled, you must press ALT+S.
  524.  
  525.            2)  Helper Button:  Setting this to "NO" disables the Helper 
  526.       button on all pages.  To open the Helper window when the Helper 
  527.       button is disabled, you must press ALT+H.
  528.  
  529.            3)  Disk Access:  Setting this to "NO" disables the Read Icon 
  530.       and Write Icon buttons in Painter.  Disabling these buttons allows 
  531.       a child (or other user) to use Painter without being able to 
  532.       access the disk and possibly corrupting files.  To access the Read 
  533.       Icon button when disk access is disabled, you must press ALT+R.  
  534.       To access the Write Icon button when disk access is disabled, you 
  535.       must press ALT+W.
  536.  
  537.            4)  Sound:  Setting this to "NO" turns off the occasional 
  538.       sounds that ToyBox II makes when certain keys are pressed.  This 
  539.       in no way affects the sound in the programs that you run under 
  540.       ToyBox II.
  541.  
  542.            5)  Cursor:  Setting this to "NO" turns off the red outline 
  543.       cursor used to indicate the current object on pages and certain 
  544.       windows.  Users without a mouse must leave this set to "YES".  
  545.       Users with a mouse can turn the cursor off if desired.
  546.  
  547.            6)  Password:  Enter an optional password a user must enter 
  548.       when attempting to exit the program with ALT+S or attempting to 
  549.       open the Helper Window with ALT+H.  The same password applies to 
  550.  
  551.                                      10
  552.       both.  This password has no effect on individual programs or 
  553.       pages.  Passwords for these are set in the Add Program or Page or 
  554.       the View/Modify Program or Page windows.
  555.  
  556.            7)  OK Button:  After you have set the options the way you 
  557.       want them, select the OK button with the mouse or press ALT+O.  
  558.       This will save the current settings to disk.  No changes take 
  559.       effect until they are saved to disk.  To close the Helper window 
  560.       without saving any changes, select the Close Window button with 
  561.       the mouse or press the ESCAPE key.
  562.  
  563.  
  564.       ============================
  565.       RUNNING AN INSTALLED PROGRAM
  566.       ============================
  567.  
  568.       After you have added a program button to ToyBox II, you can easily 
  569.       run the program by selecting the program button with the mouse, 
  570.       selecting it with the arrow keys and pressing ENTER (if the red 
  571.       outline cursor is enabled), or pressing the hot key associated 
  572.       with the program.  If you have entered the path and program 
  573.       information correctly, the program will start normally as it would 
  574.       from the DOS command line.  When you exit the program, ToyBox II 
  575.       will take over again and display the current page.
  576.  
  577.  
  578.       =======
  579.       PAINTER
  580.       =======
  581.  
  582.       Painter is an icon editor built into ToyBox II.  With Painter you 
  583.       can design your own 32x32 pixel, 16 color icons for programs you 
  584.       install in ToyBox II, or you can import Microsoft Windows icons 
  585.       and convert them to ToyBox format.
  586.  
  587.  
  588.       PAINTING ICONS - MOUSE
  589.  
  590.       Choose a color by selecting any of the 16 palette buttons with the 
  591.       mouse.  The current color will always show in the box above the 
  592.       palette buttons.  After selecting a color, position the mouse 
  593.       pointer in the desired square on the large icon grid box, then 
  594.       press any mouse button.  The square will change to the current 
  595.       color.  To paint multiple squares with the same color, continue to 
  596.       hold one of the mouse buttons down while dragging the mouse 
  597.       pointer over the squares you want to paint.  As you paint the icon 
  598.       on the large grid, you will also see the effects displayed on the 
  599.       actual-size button to the right of the large grid box. 
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.                                      11
  607.       PAINTING ICONS - KEYBOARD
  608.  
  609.       Choose a color by moving the red outline cursor to the desired 
  610.       palette button with the arrow keys, then press the ENTER key.  The 
  611.       current color will always show in the box above the palette 
  612.       buttons.  After selecting a color, press the SPACEBAR to move the 
  613.       cursor to the large icon grid box.  Move the small yellow grid 
  614.       cursor to the desired square using the arrow keys, then press the 
  615.       ENTER key.  The square will change to the current color.  To paint 
  616.       multiple squares with the same color, hold down the CTRL key as 
  617.       you press the left arrow, right arrow, Page Up, and Page Down 
  618.       keys.  The squares will be painted as the grid cursor moves over 
  619.       them.  (NOTE:  There are technical considerations with the IBM PC 
  620.       keyboard which force us to use CTRL-Page Up and CTRL-Page Down 
  621.       instead of CTRL-Up Arrow and CTRL-Down Arrow.  We realize it's 
  622.       more awkward than it should be.)  To move the cursor back to the 
  623.       palette buttons, press the SPACEBAR again.
  624.  
  625.  
  626.       FILL ALL BUTTON
  627.  
  628.       Select this button to fill the entire grid with the current color.
  629.  
  630.  
  631.       READ ICON BUTTON
  632.  
  633.       Select this button to read in an already-existing icon from disk.  
  634.       Selecting this button will cause a window with a text box to pop 
  635.       up.  Enter the path and file name of the icon file in the text 
  636.       box.
  637.  
  638.                     Example:  C:\ICONS\ABC.ICN
  639.  
  640.       The easiest way to do this is to select the Files button, which 
  641.       will cause a window containing a list of files to pop up.  This 
  642.       file list behaves exactly as the Files button described in the 
  643.       "Addding a Program or Page" section.  Drive information is 
  644.       optional if the icon file is the on same drive as ToyBox II.  
  645.       Directory information is optional if the icon file is in the same 
  646.       directory as ToyBox II.  The directory must begin with "\".  If 
  647.       you don't put an extension on the file name, Painter will assume a 
  648.       ".ICN" extension.  After you have entered the icon file 
  649.       information, press the ENTER key to read the icon file.  The icon 
  650.       will be displayed on the large icon grid box and the actual-size 
  651.       button to the right.  To close the window without reading an icon, 
  652.       select the red Close Window button.
  653.  
  654.  
  655.       WRITE ICON BUTTON
  656.  
  657.       Select this button to save the displayed icon to a disk file.  
  658.       Selecting this button will cause a window with a text box to pop 
  659.       up.  Enter the path and file name you wish to save the icon as.  
  660.  
  661.                                      12
  662.       Use the same procedures as described in the previous paragraph.  
  663.       The only difference is that you must select the OK button with the 
  664.       mouse or press ALT+O to save the file to disk.  To close the 
  665.       window without writing the icon to disk, select the Close Window 
  666.       button.
  667.  
  668.  
  669.       IMPORTING MICROSOFT WINDOWS ICON FILES
  670.  
  671.       To import a Microsoft Windows icon file (normally with a ".ICO" 
  672.       extension), read it in like you would a normal ToyBox II icon.  
  673.       Painter will make the conversion as it reads the file in.  After 
  674.       you have made any desired changes to the icon, write it to disk.  
  675.       If you use the same file name, do not use the ".ICO" extension or 
  676.       you will write over the Windows version of the icon file.  If you 
  677.       don't specify an extension, Painter will attach a ".ICN" 
  678.       extension. 
  679.  
  680.       Thousands of Microsoft Windows icon files are freely available 
  681.       from bulletin board systems and on-line services such as 
  682.       CompuServe and GEnie, or available for a small charge from 
  683.       shareware disk vendors, or available for a substantial charge from 
  684.       commercial software vendors.
  685.  
  686.       Painter can only import MS Windows icons that are in 32x32x16 
  687.       format (32 pixels by 32 pixels by 16 colors).  The vast majority 
  688.       of MS Windows icon files available are in this format.  Most MS 
  689.       Windows programs do not have separate icon files.  Instead, the 
  690.       icons are included in one of the program files (".EXE" or ".DLL").  
  691.       A single program file can have several icons stored in it.  
  692.       Painter cannot extract the icons from these files, but there are 
  693.       several shareware programs that can extract the icons and put them 
  694.       into separate icon files that Painter can import.
  695.  
  696.  
  697.       ===================
  698.       TIPS AND TECHNIQUES
  699.       ===================
  700.  
  701.  
  702.       RUNNING MULTIPLE COMMANDS
  703.  
  704.       ToyBox II allows you to directly run one program or DOS command 
  705.       per program button.  If you need to set up a button to run more 
  706.       than one program or command, you can do this by creating a batch 
  707.       file containing all the necessary commands and setting up a 
  708.       program button to run the batch file.  To easily create batch 
  709.       files you can set up a program button to open your favorite text 
  710.       editor or word processor.  The editor that is included with MS-DOS 
  711.       5.0 provides a quick, easy way to create, view and edit batch 
  712.       files and other text files.  Here is a sample setup for a program 
  713.       button to run the DOS editor:
  714.  
  715.  
  716.                                      13
  717.            Button Title:  MS-DOS Editor        Page:        NO
  718.            Password:      (your choice)        Wait:        NO
  719.            Key:           E                    Variables:   YES *
  720.            Path:          C:\DOS\              Batch:       NO
  721.            Program:       EDIT
  722.            Icon:          C:\TB2\EDIT.ICN
  723.  
  724.            *  Setting Variables to "YES" will allow you to specify the 
  725.       file to edit as a command-line parameter at the time you run the 
  726.       editor.
  727.  
  728.  
  729.       FILE MANAGER
  730.  
  731.       ToyBox II does not include built-in file management features, but 
  732.       you can easily set up a program button to access your favorite 
  733.       file management program.  The DOS Shell included with MS-DOS 5.0 
  734.       provides a graphical file manager for copying, deleting and moving 
  735.       files and directories.  Here is a sample setup for a program 
  736.       button to run the DOS Shell program:
  737.  
  738.            Button Title:  MS-DOS Shell         Page:        NO
  739.            Password:      (your choice)        Wait:        NO
  740.            Key:           S                    Variables:   NO
  741.            Path:          C:\DOS\              Batch:       NO
  742.            Program:       DOSSHELL
  743.            Icon:          C:\TB2\SHELL.ICN
  744.  
  745.  
  746.       DOS COMMAND LINE
  747.  
  748.       In some cases you may find that you need to execute a program or 
  749.       DOS command from the DOS command line.  You have two choices.  The 
  750.       first choice is to exit from ToyBox II, execute the command and, 
  751.       when you're finished, start ToyBox II again.  A better solution, 
  752.       particularly if you will need to do this on a recurring basis, is 
  753.       to set up a program button to put you at the DOS command line 
  754.       temporarily without exiting ToyBox II.  This is done by using the 
  755.       COMMAND function of DOS.  The following sample program button, 
  756.       when selected, will display the DOS prompt.  You can run any 
  757.       programs/commands as you normally would from the command line.  To 
  758.       return to ToyBox II, type EXIT at the command line and the current 
  759.       ToyBox II page will reappear.
  760.  
  761.            Button Title:  MS-DOS Prompt        Page:        NO
  762.            Password:      (your choice)        Wait:        NO
  763.            Key:           S                    Variables:   NO
  764.            Path:          C:\DOS\              Batch:       NO
  765.            Program:       COMMAND
  766.            Icon:          C:\TB2\DOS.ICN
  767.  
  768.  
  769.  
  770.  
  771.                                      14
  772.       MICROSOFT WINDOWS PROGRAMS
  773.  
  774.       If you run Microsoft Windows, but also have a number of DOS (non- 
  775.       Windows) applications, you may find it more convenient to run 
  776.       Windows as a program under ToyBox II.  You can install program 
  777.       buttons in ToyBox II for each of your DOS applications and set up 
  778.       your AUTOEXEC.BAT file to automatically open ToyBox II.  Since 
  779.       ToyBox II loads much faster than Windows, you won't have to wait 
  780.       for Windows to load before you access your DOS programs.  You can 
  781.       then set up a program button to open Windows as follows:
  782.  
  783.            Button Title:  Microsoft Windows    Page:        NO
  784.            Password:      (your choice)        Wait:        NO
  785.            Key:           W                    Variables:   NO
  786.            Path:          C:\WINDOWS\          Batch:       NO
  787.            Program:       WIN
  788.            Icon:          C:\TB2\WIN.ICN
  789.  
  790.       Another technique is to set up a page called "Windows Programs" 
  791.       and create separate program buttons for each of your Windows 
  792.       applications.  To automatically load Windows and run a specific 
  793.       Windows application, enter the Path and Program information as you 
  794.       would for a normal DOS application, then precede the program name 
  795.       with "WIN".  Here is a sample program button set up to load 
  796.       Windows and run Quicken for Windows:
  797.  
  798.            Button Title:  Quicken              Page:        NO
  799.            Password:      (your choice)        Wait:        NO
  800.            Key:           W                    Variables:   NO
  801.            Path:          C:\QUICKENW\         Batch:       NO
  802.            Program:       WIN QW.EXE
  803.            Icon:          C:\TB2\QUICKEN.ICN
  804.  
  805.  
  806.       ===================================
  807.       COMPATIBILITY WITH EARLIER VERSIONS
  808.       ===================================
  809.  
  810.       The configuration files for ToyBox II are incompatible with 
  811.       earlier versions of ToyBox.  If you are upgrading from an earlier 
  812.       version, you must reinstall programs in ToyBox II.  The icon files 
  813.       are compatible.  You can use the icons supplied with earlier 
  814.       versions, as well as any icons you have created yourself.
  815.  
  816.  
  817.       ====================
  818.       LICENSE AND WARRANTY
  819.       ====================
  820.  
  821.       ToyBox II is supplied as is.  The author disclaims all warranties, 
  822.       expressed or implied, including, without limitation, the 
  823.       warranties of merchantability and of fitness for any purpose. The 
  824.  
  825.  
  826.                                      15
  827.       author assumes no liability for damages, direct or consequential, 
  828.       which may result from the use of ToyBox II.
  829.  
  830.       ToyBox II is a "shareware program" and is provided at no charge to 
  831.       the user for evaluation.  Feel free to share it with your friends, 
  832.       but please do not give it away altered or as part of another 
  833.       system.  The essence of "user-supported" software is to provide 
  834.       personal computer users with quality software without high prices, 
  835.       and yet to provide incentive for programmers to continue to 
  836.       develop new products.
  837.  
  838.       If you find ToyBox II helpful and find that you are using it and 
  839.       continue to use it after a reasonable trial period, you must make 
  840.       a registration payment of $29 to Virtual Magic Software as 
  841.       described in the "Registration" section of this User's Guide.  The 
  842.       $29 registration fee will license one copy for use on any one 
  843.       computer at any one time.  You must treat this software just like 
  844.       a book.  An example is that this software may be used by any 
  845.       number of people and may be freely moved from one computer 
  846.       location to another, as long as there is no possibility of it 
  847.       being used at one location while it's being used at another.  Just 
  848.       as a book cannot be read by two different persons at the same 
  849.       time.
  850.  
  851.       Commercial and organizational users of ToyBox II must register and 
  852.       pay for their copies of ToyBox II within 30 days of first use or 
  853.       their license is withdrawn.  Site licenses can be arranged by 
  854.       contacting Virtual Magic Software.
  855.  
  856.       Anyone distributing ToyBox II for any kind of payment must first 
  857.       contact Virtual Magic Software for authorization.  This 
  858.       authorization is automatically granted to distributors recognized 
  859.       by the (ASP) as adhering to its guidelines for shareware 
  860.       distributors, and such distributors may begin offering ToyBox II 
  861.       immediately.
  862.  
  863.  
  864.  
  865.  
  866.  
  867.  
  868.       ToyBox II is a trademark of Virtual Magic Software.
  869.       Windows is a trademark of Microsoft Corporation.
  870.       MS-DOS is a registered trademark of Microsoft Corporation.
  871.       Quicken is a registered trademark of Intuit.
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.                                      16
  881.