home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / VISUAL_B / ARQS_ZIP / VBAPITXT.ZIP / README.NOW next >
Encoding:
Text File  |  1991-07-02  |  3.2 KB  |  75 lines
  1. WINAPI.TXT: Windows API Declarations and Constants for Visual Basic
  2. -------------------------------------------------------------------
  3.  
  4. Summary:
  5.  
  6. WINAPI.TXT supplies declarations for Microsoft Visual Basic 
  7. programmers who want to call Windows API routines.
  8.  
  9. This information applies to Microsoft Visual Basic programming system
  10. version 1.0 for Windows. 
  11.  
  12. More Information:
  13.  
  14. WINAPI.TXT is a plain ASCII text file containing the functions and 
  15. constants in the Microsoft Windows 3.0 API, declared in the format 
  16. used by Microsoft Visual Basic. 
  17.  
  18. In order to use WINAPI.TXT, you must have the book "Microsoft Windows 
  19. Programmer's Reference" (for Windows version 3) (published by 
  20. Microsoft Press, 1990), or else you must have the reference manuals 
  21. provided with the Microsoft Windows Software Development Kit (SDK).
  22.  
  23. WINAPI.TXT includes the following: 
  24.  
  25. 1. External procedure declarations for all the Microsoft Windows API 
  26.    functions that can be called from Visual Basic.
  27.  
  28. 2. Global constant declarations for all the constants used by the 
  29.    Microsoft Windows API.
  30.  
  31. 3. Type declarations for the user-defined types (structures) used by 
  32.    the Microsoft Windows API.
  33.  
  34. WINAPI.TXT is too large to be loaded directly into a Visual Basic 
  35. module. Attempting to load it directly into Visual Basic will cause an 
  36. "Out of Memory" error message.
  37.  
  38. WINAPI.TXT is also too large for the Notepad editor supplied with 
  39. Microsoft Windows, but it can be loaded by Microsoft Write. To use 
  40. WINAPI.TXT, load it into an editor (such as Microsoft Write) that can 
  41. handle large files. Copy the declarations you want and paste them into 
  42. the global module in your Visual Basic application.
  43.  
  44. NOTE: some of the Windows API declarations are very long. Some editors 
  45. will wrap these onto a second line, and will copy them as multiple 
  46. lines rather than a single line. Declarations in Visual Basic cannot 
  47. span lines, so if you paste these as multiple lines Visual Basic will 
  48. report an error. If this happens, you can either adjust the margins in 
  49. the editor before copying, or remove the line break after pasting.
  50.  
  51. The global module is the recommended place for the declarations that 
  52. you copy from the WINAPI.TXT file. However, you can place the external 
  53. procedure declarations in the Declarations section of any form or 
  54. module. You can also place the constant declarations anywhere in any 
  55. module or form code if you remove the Global keyword. Type 
  56. declarations must be placed in the global module.
  57.  
  58. Once you have pasted the declaration for a Windows API routine (as 
  59. well as any associated constant and type declarations) into your 
  60. application, you can call that routine as you would call any Visual 
  61. Basic procedure. 
  62.  
  63. For more information about declaring and calling external procedures, 
  64. see Chapter 23, "Extending Visual Basic", in the "Microsoft Visual 
  65. Basic: Programmer's Guide." 
  66.  
  67. WARNING
  68. -------
  69.  
  70. Visual Basic cannot verify the data you pass to Microsoft Windows API 
  71. routines. Calling a Microsoft Windows API routine with an invalid 
  72. argument can result in unpredictable behavior: your application, 
  73. Visual Basic, or Windows could crash or hang. When experimenting with 
  74. Windows API routines, save your work often.
  75.