home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / S12780.ZIP / READ.ME < prev    next >
Text File  |  1990-11-26  |  5KB  |  93 lines
  1.    =======================================================
  2.    BASIC PDS User Interface (UI) Toolbox Modified for OS/2 
  3.    =======================================================
  4.  
  5.  --------------------------------------------------------------------
  6. | INFORMATION PROVIDED IN THIS DOCUMENT AND ANY SOFTWARE THAT MAY    |
  7. | ACCOMPANY THIS DOCUMENT (collectively referred to as an            |
  8. | Application Note) IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY      |
  9. | KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO    |
  10. | THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A     |
  11. | PARTICULAR PURPOSE. The user assumes the entire risk as to the     |
  12. | accuracy and the use of this Application Note. This Application    |
  13. | Note may be copied and distributed subject to the following        |
  14. | conditions: 1) All text must be copied without modification and    |
  15. | all pages must be included; 2) If software is included, all files  |
  16. | on the disk(s) must be copied without modification (the DOS        |
  17. | utility DISKCOPY is appropriate for this purpose); 3) All          |
  18. | components of this Application Note must be distributed together;  |
  19. | and 4) This Application Note may not be distributed for profit.    |
  20. |                                                                    |
  21. | Copyright 1990 Microsoft Corporation. All Rights Reserved.         |
  22. | Microsoft and the Microsoft logo are registered trademarks of      |
  23. | Microsoft Corporation.                                             |
  24.  --------------------------------------------------------------------
  25.  
  26. The User Interface (UI) Toolbox sample code provided with Microsoft
  27. BASIC Professional Development System (PDS) 7.00 and 7.10 is written
  28. specifically for the MS-DOS operating system, and requires code
  29. modifications to compile and run under OS/2 protected mode.
  30.  
  31. The files UIASM.ASM, GENERAL.BAS, MENU.BAS, MOUSE.BAS, and WINDOW.BAS
  32. require code modifications to work properly under OS/2. These
  33. modifications are necessary to change over the program from MS-DOS
  34. interrupt services to the OS/2 API services for each specific
  35. function.
  36.  
  37. Microsoft Product Support Services has provided a second set of sample
  38. UI Toolbox files for use under MS OS/2 protected mode. All the UI
  39. Toolbox files have been replaced by a modified version, which includes
  40. all BASIC source code, the assembler code, and all include files. This
  41. information is provided as is with no guarantees regarding
  42. performance, and you may freely modify the code.
  43.  
  44. This package is available in the Microsoft Software/Data Library and 
  45. can be found by searching on the keyword UIDEMOS2 or S12780. 
  46.  
  47. The following files are included:
  48.  
  49.    GENERAL.BAS   GENERAL.BI   MENU.BAS     MENU.BI      MOUSE.BAS
  50.    MOUSE.BI      WINDOW.BAS   WINDOW.BI    UIDEMO.BAS   UIASM.BAS
  51.    READ.ME       UIDEMO.MAK   DOSBEEP.BAS
  52.  
  53. READ.ME is a copy of this article.
  54.  
  55. UIASM.ASM has been replaced by a BASIC version that calls OS/2 VIO API
  56. routines called UIASM.BAS.
  57.  
  58. UIDEMO.MAK is a Programmer's WorkBench (PWB) MAKE file that can be
  59. used to rebuild an executable UIDEMO program.
  60.  
  61. DOSBEEP.BAS contains a BSound routine to replace calls to SOUND, which
  62. is not supported under OS/2.
  63.  
  64. List of Modifications
  65. ---------------------
  66.  
  67. In adapting the UI Toolbox code from MS-DOS to OS/2, the main areas we
  68. have changed are at low levels, normally where the routines make
  69. specific calls to PEEK, INTERRUPT, GetCopyBox, PutCopyBox, and AttrBox
  70. routines, or calls to statements that are not supported under OS/2,
  71. such as the SOUND statement.
  72.  
  73. All references to the SOUND statement have been replaced by calls to a
  74. BSOUND routine, which is located in DOSBEEP.BAS. The SOUND statement
  75. is not supported under OS/2; instead you should use the OS/2 DOSSOUND
  76. function or the BASIC BEEP statement.
  77.  
  78. The assembler code located in the original UIASM.ASM has been replaced
  79. with BASIC code making calls to the OS/2 VIO API routines.
  80.  
  81. All references to CALL INTERRUPT have been replaced by calls to the
  82. appropriate OS/2 API calls. The MS-DOS INTERRUPT calls for the mouse
  83. support now use the OS/2 MOU API. PEEKing in MS-DOS to get the
  84. keyboard SHIFT state "GetSHIFTState" has been replaced by OS/2 KBD API
  85. calls.
  86.  
  87. Various other locations have been modified at high levels in the UI
  88. Toolbox code to correct performance that would match the MS-DOS
  89. version of the UI Toolbox.
  90.  
  91. Most modified areas have been marked with '| comments in the provided
  92. source code files.
  93.