home *** CD-ROM | disk | FTP | other *** search
/ HomeWare 14 / HOMEWARE14.bin / utils2 / runhere.arj / RUNHERE.TXT < prev    next >
Text File  |  1993-11-27  |  6KB  |  125 lines
  1. What is RunHere:
  2.   RunHere is a small utility that can be configured to start an
  3.   application or set of applications and then position and size
  4.   the application windows. Any number of application sets can be
  5.   configured and any number of applications can be in each set.
  6.  
  7. Configuring RunHere:
  8.   To configure RunHere you need to create a RUNHERE.INI file in
  9.   your Windows directory. Each section in the INI file corresponds
  10.   to an application set. The entries in each section tell RunHere
  11.   how many applications are in the set, the path to the
  12.   application to run, the title of the application window and
  13.   where to position the application window and how large to make
  14.   it.
  15.  
  16.   For example one of the sections that I use looks like:
  17.      [Network]
  18.      number=3
  19.      App1=c:\netmanag\custom.exe
  20.      Title1="Custom - C:\NETMANAG\TCPIP.CFG"
  21.      Xpos1=0
  22.      Width1=500
  23.      Ypos1=0
  24.      Height1=200
  25.      App2=c:\netmanag\ping.exe
  26.      Title2="Ping - PV"
  27.      Xpos2=161
  28.      Width2=480
  29.      Ypos2=0
  30.      Height2=200
  31.      App3=c:\netmanag\telnet.exe
  32.      Title3="Telnet - TELNET.CFG"
  33.      Xpos3=0
  34.      Width3=640
  35.      Ypos3=55
  36.      Height3=388
  37.  
  38.   Note that there are 6 basic entry names, App, Title, Xpos,
  39.   Width, Ypos, and Height and that a number, corresponding to the
  40.   application number within the set, is appended to these names.
  41.   The title specified must be the exact title that will appear in
  42.   the application window. This is how RunHere identifies the
  43.   window. If the title is wrong RunHere will put up a message box
  44.   saying that it could not find the application window. The Xpos
  45.   and Ypos correspond to the position of the upper left corner of
  46.   the application window.
  47.  
  48.   To take the guess work out of determining the position and size
  49.   of the application windows you can use the Winfo application
  50.   which is included with RunHere. The last part of this document
  51.   includes information on running Winfo.
  52.  
  53. Running RunHere:
  54.   RunHere may be started via any of the ways that Windows allows
  55.   an application to be run. It requires 1 argument, the section
  56.   name corresponding to the application set. If the argument is
  57.   not supplied or the argument does not correspond to a section
  58.   name RunHere will display a message box with an error message.
  59.   Once RunHere has started all the applications and position and
  60.   size them it will terminate.
  61.  
  62.   I tend to add the RunHere icon to the same program groups that
  63.   the applications that will be run are in. I then change the
  64.   properties of the icon so that the "Command Line" entry has the
  65.   section name following the RUNHERE.EXE path. I also change the
  66.   "Description" entry so that it lists the applications that will
  67.   be run. If the application set includes only 1 application then
  68.   I will also change the icon so that its the same as the
  69.   application to be run and then add a "*" to the description so
  70.   I can tell the RunHere and original applications apart.
  71.  
  72. Registering RunHere:
  73.   When you run RunHere you will notice that before terminating it
  74.   will display an annoying dialogue box asking you to register
  75.   your copy of RunHere. The copy of RunHere that you have is the
  76.   complete working version, no functionality has been removed or
  77.   restrictions in its use added. This allows you to make a
  78.   complete evaluation of the product. If you decide that RunHere
  79.   is a product that you want to routinely use then please register
  80.   your copy. When you register you will be sent a registration
  81.   number which when combined with your name will indicate to
  82.   RunHere that the copy has been registered and the dialogue box
  83.   will not be displayed. Instructions for adding your name and
  84.   registration number to the RUNHERE.INI file will be provided
  85.   when you register.
  86.  
  87.   To register send the name that you want RunHere registered with
  88.   and $10.00 to:
  89.        Noah Davids
  90.        6115 East Surrey Ave.
  91.        Scottsdale, AZ  85254
  92.  
  93. Winfo application:
  94.   Winfo is a small application that can provide you with the title
  95.   and position of any window on the screen. When you run Winfo it
  96.   appears as an icon at the bottom of the screen. When you click
  97.   on the icon the system menu appears. The option "Start" has been
  98.   added to the bottom of the system menu. When you click on
  99.   "Start" Winfo captures the mouse cursor and changes it into a
  100.   magnifying glass. When you next click the mouse the title,
  101.   position, and size of the window that you clicked in will be
  102.   displayed in a message box. Since many control areas (buttons,
  103.   scroll boxes, etc.) are really windows be careful where you
  104.   click or you will get the information for the control and not
  105.   for the application window. I have found that its a good idea
  106.   to click on the title bar of the application window. When you
  107.   click on the OK button in the message box the cursor will change
  108.   back to an arrow. To get the info on another window you will
  109.   need to click on the Start option again.
  110.  
  111. Distribution:
  112.   The files RUNHERE.EXE, WINFO.EXE, and RUNHERE.TXT may be freely
  113.   distributed as long as all three files are distributed together
  114.   and as long as the distributor clearly indicates that any
  115.   charges are for the distribution process itself (connect time,
  116.   media costs, shipping, etc.) and not for the product.
  117.  
  118. Version Changes:
  119.   1.1 Minor changes in WINFO.EXE to make the position lables match
  120.       what the RUNHERE.INI file requires. Also the title is now
  121.       displayed in brackets to make leading and trailing spaces
  122.       in the title obvious.
  123.  
  124.   1.2 Minor change in the RUNHERE dialog box and documentation
  125.       to reflect my new address.