home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-385-Vol-1of3.iso / t / tbkopen.zip / README.TXT < prev    next >
Text File  |  1991-01-30  |  2KB  |  58 lines
  1.                  **Generic ToolBook Open Dialog Box**
  2.  
  3. TBKOPEN.DLL is a Windows Dynamic Link Library (DLL) that adds 
  4. generic open dialog box functionality to ToolBook.  This document 
  5. provides the information necessary to use the DLL from OpenScript, 
  6. ToolBook's programming language.
  7.  
  8. **linkDLL Statement**
  9. You must link to the DLL with the following control structure:
  10.  
  11.     linkDLL "tbkopen.dll"
  12.         STRING OpenDlg(STRING, STRING, STRING, STRING)
  13.     end linkDLL    
  14.  
  15. **Return Value**
  16. OpenDlg returns a string that contains the fully qualified 
  17. path name of the file the user chooses to open.  If the user 
  18. dismisses the dialog box without choosing a file, OpenDlg 
  19. returns NULL, and sysError is set to -1.
  20.  
  21. OpenDlg does not open the selected file.  It simply returns the fully 
  22. qualified path name of the file the user chooses.
  23.  
  24. **Parameters**
  25. OpenDlg requires four string parameters.  The first parameter is 
  26. the search path, the second parameter is the file specification, 
  27. the third parameter is a prompt string that is displayed at the 
  28. top of the dialog box (not on the caption bar), and the fourth 
  29. parameter is the dialog box caption.
  30.  
  31. If the first parameter is null, the current search directory is
  32. used.  If the second parameter is null, *.* is assumed.  
  33. The prompt string is blank if none is provided.
  34.  
  35. **Example**
  36.  
  37. [Put this handler in your book script]
  38.     to handle enterBook
  39.         linkDLL "tbkopen.dll"
  40.             STRING OpenDlg(STRING, STRING, STRING, STRING)
  41.         end linkDLL
  42.     end enterBook
  43.  
  44. [Put this handler in an object script]
  45.     to handle buttonUp
  46.         get OpenDlg("c:\lotus", "*.txt", "Please choose" && \
  47.             the text file you would like to open...", "Open")
  48.         openFile it
  49.     
  50.     [more statements...]
  51.     end buttonUp
  52.  
  53.  
  54. 7/9/90
  55. Jeff Day, Asymetrix Corporation
  56.  
  57. Updated 1/30/91
  58.