home *** CD-ROM | disk | FTP | other *** search
/ High Voltage Shareware / high1.zip / high1 / DIR36 / DRGDRP.ZIP / DRAGDROP.TXT < prev    next >
Text File  |  1993-11-05  |  6KB  |  237 lines
  1. DragDrop Driver 1.0 for GENSCRNX
  2.  
  3.  
  4.  
  5. The DRAGDROP.PRG driver is designed for GENSCRNX 1.7a or later.  
  6. The DragDrop driver also requires 3D.PRG driver 1.6 or later for 
  7. automatically creating 3D effects for the drag and drop objects.  The 
  8. DragDrop driver is entirely written in FoxPro and fully compatible with 
  9. FoxPro 2.0 and FoxPro 2.5 (all platforms).  The only API calls made are 
  10. in the Windows platform to turn off the Windows mouse cursor while in 
  11. the drag mode.  If FOXTOOLS.FLL is not found in the FOXPROW.EXE 
  12. directory, the  mouse cursor will not be turned off while dragging objects.
  13.  
  14. Sample code files for the DragDrop driver can be found on 
  15. CompuServe's FoxForum (section 3rd Party Products).  The first set of 
  16. sample code is contained in a file called DGDP01.ZIP.
  17.  
  18.  
  19.  
  20.  
  21. IMPORTANT
  22.  
  23.  
  24. This documentation file will be enhanced extensively and uploaded (in 
  25. DRGDRP.ZIP) on CompuServe's FoxForum (section 3rd Party Products) 
  26. by 11/12/93.  Since this file does not include directive definition, 
  27. experiment with the sample screens in DGDP01.ZIP to help learn the 
  28. DragDrop directives.  Also, reading the DragDrop event/property 
  29. definitions for Visual Basic 2.0 or later will help since
  30.  
  31.  
  32.  
  33.  
  34. INSTALLATION
  35.  
  36.  
  37. Read documentation on installation supplied with GENSCRNX before 
  38. using the DragDrop driver and sample code.
  39.  
  40.  
  41.  
  42.  
  43. UP AND RUNNING
  44.  
  45.  
  46. To enable the DragDrop driver, place the following line of code in the 
  47. Setup snippet of a screen:
  48.  
  49. *:SCXDRV3 DRAGDROP
  50. *:SCXDRV5 3D
  51.  
  52.  
  53. To enable the DragDrop driver globally for all FoxPro for Windows 
  54. screens, place the following in the CONFIG.FPW:
  55.  
  56. _SCXDRV3="<path>DRAGDROP.PRG"
  57. _SCXDRV5="<path>3D.PRG"
  58.  
  59. with the proper <path> of the DRAGDROP.PRG and 3D drivers.
  60.  
  61. Notes:
  62. The 3D driver is optional for use with the DragDrop driver.  If the 3D 
  63. driver is not installed with the DragDrop driver, 3D effects will not be 
  64. generated for the drag and drop objects.  Although all of the drag and 
  65. drop object combinations have a default 3D effect generated by the 
  66. DragDrop driver, any *:3D directive in a drag and/or drop object will 
  67. override the default 3D effect for that object.  For each drag and/or drop 
  68. object, the DragDrop driver overrides any global 3D settings specified in 
  69. the Setup snippet.  For further information about using the 3D directives 
  70. for the 3D driver, refer documentation supplied with 3DFOX.ZIP.
  71.  
  72.  
  73.  
  74.  
  75. SETUP SNIPPET DIRECTIVE REFERENCE
  76.  
  77.  
  78. *:SCXDRV3 <path>DRAGDROP
  79. *:SCXDRV5 <path>3D
  80.  
  81. Specify SCX driver #3 to execute the DRAGDROP.PRG driver function.
  82. Specify SCX driver #5 to execute the 3D.PRG driver function (optional).
  83.  
  84.  
  85. *:NOICONLIST
  86.  
  87. Disable generation of null function calls for .ICO and .BMP files specified 
  88. with the DragDrop directives.  The DragDrop driver default is to 
  89. automatically create a list of the .ICO and .BMP files used for both static 
  90. and animated pictures to force a project to find all the necessary files.  
  91. The file names may include a directory path name which is required if the 
  92. files are not in the FoxPro file search path.
  93.  
  94. Example:
  95. * Start of null icon file list
  96. RETURN [m.null]
  97. DO eye.ico
  98. DO face01.ico
  99. DO face02.ico
  100. DO face03.ico
  101. * End of null icon file list
  102.  
  103.  
  104.  
  105.  
  106. EVENT/PROPERTY REFERENCE
  107.  
  108.  
  109.  
  110. *:DblClick <function name>
  111.  
  112. Must be used with *:DragMode for a drag events only.
  113.  
  114.  
  115. *:DragDrop [<function name>]
  116.  
  117.  
  118. *:DragEnter [<function name>]
  119.  
  120.  
  121. *:DragHeight <rows>
  122.  
  123.  
  124. *:DragIcon [<expC>]
  125.  
  126.  
  127. *:DragLeave [<function name>]
  128.  
  129.  
  130. *:DragMode [<function name>]
  131.  
  132.  
  133. *:DragOver [<function name>]
  134.  
  135.  
  136. *:DragWidth <columns>
  137.  
  138.  
  139. *:DragWithin [<function name>]
  140.  
  141.  
  142. *:ObjArray [<array name>]
  143.  
  144.  
  145. *:ObjClass <expC>
  146.  
  147.  
  148. *:ObjHeight <expC>
  149.  
  150.  
  151. *:ObjMsg <expC>
  152.  
  153.  
  154. *:ObjTxt [<expC>]
  155.  
  156.  
  157. *:ObjWidth <expC>
  158.  
  159.  
  160. *:OverButton  [<variable name>]
  161.  
  162.  
  163. *:OverHeight <expC>
  164.  
  165.  
  166. *:OverIcon  [<expC>]
  167.  
  168.  
  169. *:OverTxt [<expC>]
  170.  
  171.  
  172. *:OverWidth <expC>
  173.  
  174.  
  175.  
  176.  
  177. DRAG EVENT FUNCTION REFERENCE
  178.  
  179.  
  180. animate(<expC1>, <expN1>, <expN2> | <expC2>, <expN3> | <expC3> 
  181. [,<expN4>])
  182.  
  183.  
  184.  
  185.  
  186. ADDITIONAL INFORMATION
  187.  
  188.  
  189.  
  190. If a public variable called _DRAGDROP is set to OFF, the DragDrop 
  191. driver will be disabled and all DragDrop code generation will be 
  192. suppressed.  _DRAGDROP='OFF' is useful when prototyping a project 
  193. and DragDrop code generation is not needed for testing but the time it 
  194. takes for a project to re-build needs to be as short as possible.  The 
  195. overhead time of using the DragDrop driver depends on the number and 
  196. type of drag and drop objects generated for the screen.  
  197. DRAGDROP=OFF can be placed in the CONFIG.FPW file to disable 
  198. DragDrop code generation without being dependent on a public variable 
  199. call _DRAGDROP existing.  If both a public variable _DRAGDROP and 
  200. DRAGDROP =ON | OFF in the CONFIG.FPW file, the public variable has 
  201. precedence.
  202.  
  203.  
  204.  
  205.  
  206. COPYRIGHT NOTICE
  207.  
  208.  
  209. Compressed file: DRGDRP.ZIP
  210. System: GenScrnX
  211. Author: Ken R. Levy
  212. Company: Jet Propulsion Laboratory
  213. Copyright: None (Public Domain)
  214.  
  215. All source code and documentation contained in DRGDRP.ZIP was 
  216. developed at the Jet Propulsion Laboratory in Pasadena, Calif. and has 
  217. been placed into the public domain.  You may use, modify, copy, 
  218. distribute, and demonstrate any source code, example programs, or 
  219. documentation contained in DRGDRP.ZIP freely without copyright 
  220. protection.  All files contained in DRGDRP.ZIP are provided 'as is' without 
  221. warranty of any kind.  In no event shall its authors, contributors, or 
  222. distributors be liable for any damages.
  223.  
  224.  
  225.  
  226.  
  227. COMMENTS/SUGGESTIONS/PROBLEMS/QUESTIONS
  228.  
  229.  
  230. Please use CompuServe's FoxForum (section 3rd Party Products) 
  231. directed to:
  232.  
  233. Ken Levy 76350,2610
  234.  
  235. -----------------------------------------------------------
  236.  
  237.