home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 10 / 10.iso / l / l410 / 2.ddi / WINAPI / README.TX$ / README.bin
Encoding:
Text File  |  1992-02-13  |  5.9 KB  |  149 lines
  1.                                   README.TXT
  2.  
  3.                               Release Notes for
  4.  
  5.              Microsoft (R) Windows Programmer's Online Resource
  6.  
  7.                  (C) Copyright Microsoft Corporation, 1992
  8.  
  9.  
  10.  
  11. ===============================================================================
  12. Contents
  13. ===============================================================================
  14.  
  15. Part    Description
  16. ----    -----------
  17.  
  18. 1       Contents of the Windows API Reference
  19.  
  20. 2       Using APIXREF.HLP
  21.  
  22. 3       Using WINAPI.TXT
  23.  
  24. 4       Using WINSDK.HLP
  25.  
  26.  
  27.  
  28. ===============================================================================
  29. Part 1: Contents of This Package
  30. ===============================================================================
  31.  
  32. This package includes the following files:
  33.  
  34. APIXREF.HLP     Windows API Cross-Reference Help
  35.                 --------------------------------
  36.                 A Microsoft Windows Help file that provides a cross-reference 
  37.                 to the functions and constants in the Microsoft Windows 3.0
  38.                 Applications Programming Interface (API).
  39.  
  40. README.TXT      The file you are now reading
  41.                 ----------------------------
  42.  
  43. WINAPI.TXT      Windows API Declarations and Constants
  44.                 --------------------------------------
  45.                 A plain ASCII text file containing the functions and constants
  46.                 in the Microsoft Windows 3.0 API, declared in the format used 
  47.                 by Microsoft Visual Basic (TM). 
  48.  
  49.  
  50. WINSDK.HLP      Windows Software Development Kit API Help
  51.                 -----------------------------------------
  52.                 A Microsoft Windows Help file containing complete reference
  53.                 information for the functions, messages, and data structures
  54.                 in the Microsoft Windows API.  This is the same file that is 
  55.                 shipped with the Microsoft Windows Software Development Kit.
  56.  
  57.  
  58.  
  59.  
  60.  
  61. ===============================================================================
  62. Part 2: Using APIXREF.HLP
  63. ===============================================================================
  64.  
  65. APIXREF.HLP is a Microsoft Windows Help file.  Open it by clicking
  66. on the WIN API X-REF Icon installed in the Professional Toolkit group in
  67. the Windows Program Manager.
  68.  
  69.  
  70. APIXREF.HLP includes:
  71.   o Windows API routines listed alphabetically and grouped by first letter.
  72.  
  73.   o Windows API routines listed alphabetically and grouped by DLL.
  74.  
  75.   o Constants used by the Windows API, together with their values (as given
  76.     in the WINDOWS.H file supplied with the Microsoft Windows 3.0 SDK) listed 
  77.     alphabetically and grouped by first letter.
  78.  
  79.  
  80.  
  81. ===============================================================================
  82. Part 3: Using WINAPI.TXT
  83. ===============================================================================
  84.  
  85. WINAPI.TXT is a text file that supplies declarations for Microsoft Visual Basic
  86. programmers who want to call Windows API routines.
  87.  
  88. It includes: 
  89.   o External procedure declarations for all the Microsoft Windows API functions
  90.     that can be called from Visual Basic.
  91.  
  92.   o Global constant declarations for all the constants used by the Microsoft
  93.     Windows API.
  94.  
  95.   o Type declarations for the user-defined types (structures) used by the
  96.     Microsoft Windows API.
  97.  
  98. WINAPI.TXT is too large to be loaded directly into a Visual Basic module.
  99. Attempting to load it directly into Visual Basic will cause an "Out of Memory"
  100. error message.
  101.  
  102. WINAPI.TXT is also too large for the Notepad editor supplied with Microsoft 
  103. Windows, but it can be loaded by Microsoft Write.  To use WINAPI.TXT, load it 
  104. into an  editor (such as Microsoft Write) that can handle large files.  Copy 
  105. the declarations you want and paste them into the global module in your Visual 
  106. Basic application.
  107.  
  108. NOTE: some of the Windows API declarations are very long.  Some editors will 
  109. wrap these onto a second line, and will copy them as multiple lines rather 
  110. than a single line.  Declarations in Visual Basic cannot span lines, so if 
  111. you  paste these as multiple lines Visual Basic will report an error.  
  112. If this happens, you can either adjust the margins in the editor before 
  113. copying, or remove the line break after pasting.
  114.  
  115. The global module is the recommended place for the declarations that you copy
  116. from the WINAPI.TXT file.  However, you can place the external procedure
  117. declarations in the Declarations section of any form or module.  You can also
  118. place the constant declarations anywhere in any module or form code if you 
  119. remove the Global keyword.  Type declarations must be placed in the global 
  120. module.
  121.  
  122. Once you have pasted the declaration for a Windows API routine (as well as any 
  123. associated constant and type declarations) into your application, you can call 
  124. that routine as you would call any Visual Basic procedure.  
  125.  
  126. For more information about declaring and calling external procedures, see 
  127. Chapter 23, "Extending Visual Basi,c" in the Visual Basic "Programmer's Guide."  
  128.  
  129. WARNING 
  130. -------
  131. Visual Basic cannot verify the data you pass to Microsoft Windows API routines.
  132. Calling a Microsoft Windows API routine with an invalid argument can result 
  133. in unpredictable behavior: your application, Visual Basic, or Windows could 
  134. crash or hang.  When experimenting with Windows API routines, save your work
  135. often.
  136.  
  137.  
  138.  
  139. ===============================================================================
  140. Part 4: Using WINSDK.HLP
  141. ===============================================================================
  142.  
  143. WINSDK.HLP is a Microsoft Windows Help file.  Open it by double-clicking on 
  144. the WIN SDK HELP icon in Professional Toolkit group in the Windows Program 
  145. Manager.
  146.         
  147. WINSDK.HLP provides detailed information about each of the functions, messages,
  148. and data structures in the Microsoft Windows API.
  149.