home *** CD-ROM | disk | FTP | other *** search
/ Programming Tool Box / SIMS_2.iso / vb_code1 / mhelp / read.txt < prev   
Text File  |  1992-01-29  |  3KB  |  100 lines
  1.                      READ.ME File for MHELP.VBX
  2.  
  3. This DLL is provided as a courtesy to the Visual Basic programming
  4. community by MicroHelp, Inc. MicroHelp is the leading publisher of
  5. add-on products for Microsoft Visual Basic, Microsoft QuickBASIC and
  6. Microsoft BASIC Professional Development System.
  7.  
  8. The routines in the accompanying DLL represent only a handful of the
  9. routines that are in MicroHelp Muscle. Muscle includes over 400 
  10. assembly language and other routines that add speed and functionality
  11. to Visual Basic programs. For more information on MicroHelp's products,
  12. call 1-800-922-3383 or (404) 594-1185. You can also write to:
  13.  
  14.    MicroHelp, Inc.
  15.    4636 Huntridge Drive
  16.    Roswell GA 30075-2012
  17.    USA
  18.    
  19.    FAX: (404) 594-9629
  20.    
  21. You are free to use the routines provided in this DLL without
  22. restriction. That means you may distribute the DLL with your .EXE
  23. files that require the DLL. 
  24.  
  25. You may also distribute the DLL and related files (see below) in
  26. archive or ZIP format. In fact, we encourage you to distribute
  27. them!  All we ask is that you place all the files listed below
  28. in the archive/zip, without modification.
  29.  
  30. The files that are included as a part of this package are:
  31.  
  32.    READ.ME     This file
  33.    MHELP.BI    Text file containing routine declarations
  34.    MHELP.FRM   Form used with MHELP.MAK
  35.    MHELP.MAK   Project file demonstrating the routines
  36.    MHELP.VBX   The DLL itself
  37.  
  38. USING THE DLL
  39. -------------   
  40. In order to use the DLL, the file MHELP.VBX must be in your PATH.
  41.  
  42. In addition, the routines you wish to use must be declared for VB. The
  43. easiest way to accomplish this is to insert the contents of MHELP.BI
  44. into your global module.
  45.  
  46. Once the routines have been declared in your app, using them is simply
  47. a matter of invoking them. Please see the example application MHELP.MAK
  48. for real code examples.
  49.  
  50. ROUTINE DESCRIPTIONS
  51. --------------------
  52.  
  53. MhCtrlHwnd% returns the HWND of any control. This value is
  54. useful for passing to Windows API routines. To use the routine,
  55. simply pass the CtlName of the property. For example:
  56.  
  57.    ' Assuming you have a text box control named "Text1"
  58.    Text1Hwnd% = MhCtrlHwnd(Text1)
  59.    
  60. The function result Text1Hwnd% can be used for any Windows API routine
  61. that requires an "hwnd".
  62.  
  63. MhPeekByte is similar to QuickBASIC's PEEK statement. Instead of
  64. using DEF SEG, you pass a corresponding value in Segm%. For example,
  65. suppose in QuickBASIC you have the following:
  66.  
  67.    DEF SEG = &H40
  68.    X% = PEEK(&H10)
  69.    DEF SEG
  70.    
  71. To read the same value using MhPeekByte:
  72.  
  73.    X% = MhPeekByte%(&H40, &H10)
  74.  
  75. MhPokeByte is similar to MhPeekByte, but is used to write a value. For
  76. example, suppose you have this code in QuickBASIC:
  77.  
  78.    DEF SEG = &H40
  79.    POKE &H10, 65
  80.    DEF SEG
  81.  
  82. The equivalent code for MhPokeByte is:
  83.  
  84.    MhPokeByte 65, &H40, &H10
  85.    
  86. The balance of the routines are used *exactly* like their PDS
  87. 7.x counterparts:
  88.  
  89.    Inp%, Out, VarPtr%, VarSeg%, VarSegPtr%, SAdd%, SSeg%, SSegAdd&
  90.    
  91. Note that for variable-length strings, you should use Sadd%, SSeg% and
  92. SSegAdd&. The Varxxx routines can be used on all other types of variables.
  93.  
  94. All routines are provided on an "as-is" basis, without warranty of any
  95. kind. If you have a question about using the routines, please leave
  96. a message in the MSBASIC conference of CompuServe, in subtopic #5 
  97. (Visual Basic). Please do not call MicroHelp for support for this
  98. free DLL.
  99.  
  100.