home *** CD-ROM | disk | FTP | other *** search
/ Frostbyte's 1980s DOS Shareware Collection / floppyshareware.zip / floppyshareware / GLEN / DVAPMENU.ZIP / DVAPMENU.DOC next >
Text File  |  1989-04-11  |  8KB  |  194 lines
  1.                    DESQview Application Program Menu
  2.  
  3.                           Gregory Stewart
  4.                           RCHVMV(GSTEWART)
  5.  
  6.                           April 10, 1989
  7.                            Version 1.0
  8.  
  9.  
  10.  
  11. The DESQview Application Program Menu program (DVAPMENU) provides
  12. nested menu support for the DESQview environment.  It is invoked from
  13. the DESQview Open Window menu, reads a menu definition file and
  14. displays a program selection menu which looks very much like the
  15. DESQview Open Window menu.  Programs are started from this panel by
  16. selecting them via mouse or keyboard in the same manner as from the
  17. Open Window menu.
  18.  
  19.  
  20.  
  21. INSTALLING THE DEMONSTRATION PROGRAMS:
  22.  
  23. The DVAPMENU package consists of this documentation and a single
  24. LOADRAMed file, DVAPMENU RAMBIN. This program contains the menu
  25. program, a menu definition file, example programs, and DESQview
  26. Program Information Files (DVPs) for the example programs.
  27.  
  28. To install and run the examples, put all of the LOADRAMed files into a
  29. directory on your hard drive.  Then run Add a Program from the
  30. DESQview Open Window menu.  When Add a Program comes up, select
  31. "Other" from the top of the menu.  Specify the drive and subdirectory
  32. into which you copied the files.  Add a Program should find the EX-
  33. PIF.DVP file in the directory and will display "DVAPMENU Examples" as
  34. a selectable program to Add.  Select the program, hit the Enter key to
  35. add it and keep hitting Enter until the item is added to your menu.
  36. Then you may run DVAPMENU Examples as you would any other installed
  37. program.
  38.  
  39.  
  40.  
  41. CREATING A DVAPMENU MENU DEFINITION FILE
  42.  
  43. The menu definition file (MDF) is a text file that defines the
  44. application menu. It contains two types of statements, and each
  45. statement can contain one or more keywords and keyword values. An
  46. example of a MDF, illustrating all of the supported keywords, is shown
  47. below:
  48.  
  49.     { DESQview Data Base sub-menu }
  50.     :Menu title='Data base' autoend=y
  51.     :Item id=C9 desc='1989 checkbook' dvp=c:\dv\pcfdb.dvp
  52.           path=d:\pcfdb  parm=/drive,c,/file,cb89,/path,\data\cb89
  53.     :Item id=B9 desc='1989 budget'    dvp=c:\dv\budg89.dvp
  54.           path=d:\pcfdb  parm=/drive,c,/file,bu89,/path,\data\cb89
  55.     :Item id=AD desc='Name & address' dvp=c:\dv\address.dvp
  56.  
  57. The first line is a comment. Comments can appear anywhere, and are
  58. enclosed in brackets.
  59.  
  60. The second line starts the menu definition. The :MENU tag must be the
  61. first tag in the file. It contains two parameters, TITLE and AUTOEND.
  62.  
  63. The TITLE parameter specifies the title that goes at the top of the
  64. menu. If the title contains a blank, it must be enclosed in single
  65. quotes.
  66.  
  67. The AUTOEND parameter indicates whether the menu program should end
  68. after initiating a selected program. If it is not automatically ended,
  69. then either the ESC key or mouse button 2 can be used to end it.
  70.  
  71. The :ITEM tag defines an application entry on the menu. There may be
  72. up to twenty :ITEM tags per MDF. Valid parameters are ID, DESC, DVP,
  73. PATH, and PARM.
  74.  
  75. The ID parameter defines a two-keystroke sequence used to select the
  76. application from the menu. An application may also be selected by
  77. mouse button 1.
  78.  
  79. The DESC parameter specifies an application description that goes on
  80. the menu. If the description contains a blank, it must be enclosed in
  81. single quotes.
  82.  
  83. the DVP parameter specifies the file name of the DESQview Program
  84. Information File. If the DVP files are not in DVAPMENU's current
  85. directory, then the file names must contain the pathname as specified
  86. above. Refer to 'Creating a DVP file' below for additional
  87. information.
  88.  
  89. The PATH parameter specifies the directory that is to be made current
  90. when the application program is started. There are three ways to set
  91. the application's current directory: if the DIRECTORY field in the DVP
  92. is not blank (contains a directory specification), the application
  93. starts in the PIF-specified directory; if the DIRECTORY field in the
  94. DVP is blank, and the PATH parameter is specified, the application
  95. starts in the directory indicated by the PATH parameter; if the
  96. DIRECTORY field in the DVP is blank, and the PATH parameter is NOT
  97. specified, the application is started in DVAPMENU's current directory.
  98.  
  99. The PARM parameter specifies the parameters that are to be passed to
  100. the application program. If the parameters contain a blank, they must
  101. be enclosed in single quotes. In order for these parameters to be
  102. passed to the application program, the PARAMETERS field in the DVP
  103. must contain the single character '?'. If the PARAMETERS field in the
  104. DVP does NOT contain the single character '?', then the application
  105. will receive the parameters specified in the DVP.
  106.  
  107.  
  108.  
  109. CREATING A DESQVIEW PROGRAM INFORMATION FILE:
  110.  
  111. If you want to use DVAPMENU for nested menus, then you probably don't
  112. want the applications to appear on the DESQview Open Window menu. To
  113. do this, you must perform the following steps:
  114.  
  115. 1) ADD the application program to the DESQview Open Window menu via
  116.    the DESQview Add a Program (AP) function.
  117.  
  118. 2) COPY the xx-PIF.DVP file created by Add a Program to another file.
  119.    If you don't want it to appear on the Add a Program panel, call it
  120.    something other than xx-PIF.DVP. In the demonstration above, only
  121.    DVAPMENU Examples appears on the Add a Program display, because
  122.    only its DVP has a name of the form EX-PIF.DVP.
  123.  
  124. 3) DELETE the application program from the DESQview Open Window menu
  125.    via the DESQview Delete a Program (DP) function.
  126.  
  127. A word of caution: make sure you have the DVP set up the way you want
  128. it before deleting it from the DESQview Open Window menu. The DESQview
  129. Change a Program (CP) function appears to only work on programs on the
  130. Open Window menu, and it is a cumbersome procedure to get it back on
  131. the menu. However, it can be done. You have to rename the DVP file to
  132. a name of the form xx-PIF.DVP, use Add a Program (AP) to add it back
  133. to the Open Window menu, change it via Change a Program (CP), then go
  134. through steps 2 and 3 above to get it off the menu again.
  135.  
  136.  
  137.  
  138. ADDING NESTED MENUS TO THE DESQVIEW OPEN WINDOW MENU
  139.  
  140. The easiest way that I have found to add nested menus to the Open
  141. Window menu is to use Change a Program on an existing nested menu
  142. entry, change the KEYS USED TO OPEN MENU field, and change the
  143. PARAMETERS field to point it to a different Menu Definition file. If
  144. you installed the demonstration programs above, you can use Change a
  145. Program on the EX entry.
  146.  
  147. Here's the complete information that goes in to the Program
  148. Information File for DVAPMENU. This example is for the DATABASES
  149. nested menu used in the Menu Definition File example above:
  150.  
  151.                                Change a Program
  152.  
  153.  Program Name............: >Data base menu
  154.  
  155.  Keys to Use on Open Menu: DB                      Memory Size (in K):  32
  156.  
  157.  Program...: c:\dv\dvapmenu.exe
  158.  
  159.  Parameters: c:\dv\database.mdf
  160.  
  161.  Directory.:
  162.  
  163.  Options:
  164.                   Writes text directly to screen.......: [N]
  165.                   Displays graphics information........: [N]
  166.                   Virtualize text/graphics (Y,N,T).....: [N]
  167.                   Uses serial ports (Y,N,1,2)..........: [N]
  168.                   Requires floppy diskette.............: [N]
  169.  
  170.  
  171.  
  172.                       Change a Program Advanced Options
  173.  
  174.  System Memory (in K).......:   1   Maximum Program Memory Size (in K)..:
  175.  
  176.  Script Buffer Size.......:     0   Maximum Expanded Memory Size (in K):
  177.  
  178.  Text Pages: 1  Graphics Pages: 0   Initial Mode:        Interrupts:    to
  179.  
  180.  Window Position:
  181.     Maximum Height:  25       Starting Height:   0       Starting Row...:   0
  182.     Maximum Width.:  80       Starting Width.:   0       Starting Column:  80
  183.  
  184.                                 Shared Program
  185.  Pathname..:
  186.  Data......:
  187.  
  188.  Close on exit (Y,N,blank)......: [Y]  Uses its own colors..............: [N]
  189.  Allow Close Window command.....: [Y]  Runs in background (Y,N,blank)...: [Y]
  190.  Uses math coprocessor..........: [N]  Keyboard conflict (0-4)..........: [0]
  191.  Share CPU when foreground......: [Y]  Share EGA when foreground/zoomed.: [Y]
  192.  Can be swapped out (Y,N,blank).: [ ]  Protection level (0-3)...........: [0]
  193.  
  194.