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