home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / ICLUI.ZIP / HELLO6 / README6.TXT < prev   
Text File  |  1993-03-09  |  13KB  |  177 lines
  1. ***************************************************************************
  2. * HELLO WORLD SAMPLE PROGRAM - Version 6: Readme File (README6.TXT)       *
  3. *                                                                         *
  4. * COPYRIGHT: Copyright(C) International Business Machines Corp.,1992,1993.*
  5. *                                                                         *
  6. * DISCLAIMER OF WARRANTIES:                                               *
  7. *   The following [enclosed] code is sample code created by IBM           *
  8. *   Corporation.  This sample code is not part of any standard IBM product*
  9. *   and is provided to you solely for the purpose of assisting you in the *
  10. *   development of your applications.  The code is provided "AS IS",      *
  11. *   without warranty of any kind.  IBM shall not be liable for any damages*
  12. *   arising out of your use of the sample code, even if they have been    *
  13. *   advised of the possibility of such damages.                           *
  14. *                                                                         *
  15. * Problems: - Setting a Color or Font does not allows work.               *
  16. *           - Font Menu Item is not working in some cases.                *
  17. *           - Enter Key does not work on the main window with buttons     *
  18. *-------------------------------------------------------------------------*
  19. * C++ Hello World Vision 6 Key Functions:                                 *
  20. *                                                                         *
  21. *      - Command Line option to use Enlish or Portuguese DLL resources    *
  22. *      - Add Open Menu Item and use File Dialog                           *
  23. *      - Show MessageBox when can not read input file from File Dialog    *
  24. *      - Add Push Buttons & Set Canvas to change alignment                *
  25. *      - Add Menu PopUp for changing the alignment                        *
  26. *      - Change Status Area to Split Canvas and add Date & Time           *
  27. *      - Add ATimeHandler & Update Time on Status Area                    *
  28. *      - Add HELLOWPS.CMD to create Workplace Folder with Programs        *
  29. ***************************************************************************
  30.  
  31. ***************************************************************************
  32. * File list:                                                              *
  33. *   README6.TXT  - readme command file for HELLO6.EXE                     *
  34. *   AHELLOW6.CPP - source code for main() and AHelloWindow class          *
  35. *   AHELLOW6.HPP - class header file for AHellowWindow                    *
  36. *   AHELLOW6.H   - symbolic defintion file for HELLO6.EXE                 *
  37. *   ADIALOG6.CPP - source code to create the ATextDialog class            *
  38. *   ADIALOG6.HPP - class header file for ATextDialog                      *
  39. *   AEARTHW6.CPP - source code to create the AEarthWindow class           *
  40. *   AEARTHW6.HPP - class header file for AEarthWindow                     *
  41. *   ACOLORW6.CPP - source code to create the AColorWindow class           *
  42. *   ACOLORW6.HPP - class header file for AColorWindow                     *
  43. *   ASPEEDW6.CPP - source code to create the ASpeedWindow class           *
  44. *   ASPEEDW6.HPP - class header file for ASpeedWindow                     *
  45. *   ATIMEHDR.CPP - source code to create the ATimeHandler class           *
  46. *   ATIMEHDR.HPP - class header file for ATimeHandler                     *
  47. *   AHELLOWE.RC  - English resource file for HELLO6.EXE                   *
  48. *   AHELLOWP.RC  - Portuguese resource file for HELLO6.EXE                *
  49. *   AHELLOW6.ICO - icon file for HELLO6.EXE                               *
  50. *   BRAZIL.ICO   - icon file for Postuguese option of HELLO6.EXE          *
  51. *   ADIALOGE.DLG - English dialog resource source file for HELLO6.EXE     *
  52. *   ADIALOGP.DLG - Portuguese dialog resource source file for HELLO6.EXE  *
  53. *   ADIALOGE.RES - dialog resource file for HELLO6.EXE                    *
  54. *   AHELLOW6.IPF - help file for HELLO6.EXE                               *
  55. *   AHELLOW6.INI - Profile for HELLO6.EXE                                 *
  56. *   AHELLOW6.DEF - module definition file for HELLO6.EXE                  *
  57. *   AHELLOWE.DEF - module definition file for AHELLOWE.DLL                *
  58. *   AMAKE6.MAK   - make file to create HELLO6.EXE                         *
  59. *   AMAKE6.CMD   - command file to create HELLO6.EXE                      *
  60. *   BUILD6.CMD   - command file to compile, link and run HELLO6.EXE       *
  61.  *  HELLOWPS.CMD - command file to create WPS Folder with Program Objects *
  62. *   CLEANUP6.CMD - command file to cleanup (erase) generated files:       *
  63. *                  HELLO6.EXE, AHELLOW6.OBJ, ADIALOG6.OBJ, AEARTHW6.OBJ,  *
  64. *                  AHELLOW6.MAP, AHELLOW6.HLP, AHELLOW6.ERR, AHELLOWE.RES,*
  65. *                  AHELLOWE.DLL, AHELLOWP.DLL, ATIMEHDR.OBJ              *
  66. ***************************************************************************
  67.  
  68. ***************************************************************************
  69. *                                                                         *
  70. * File Relationship Diagram (Files in Caps, Programs in lower case)       *
  71. *                                                                         *
  72. *                              ADIALOGE.RES                               *
  73. *                                   │                                     *
  74. *                 AHELLOW6.H     dlgedit         iconedit                 *
  75. *                    │  │           │               │                     *
  76. * AHELLOW6.HPP       │  ├─────>ADIALOGE.DLG    AHELLOW6.ICO BRAZIL.ICO    *
  77. *  ADIALOG6.HPP      │  ├──────>ADIALOGP.DLG        │         │           *
  78. *   AEARTHW6.HPP     │  │           │               │         │           *
  79. *    ATIMEHDR.HPP    │  │           │               │         │           *
  80. *     ACOLORW6.HPP   │  │           │               │ ┌───────┘           *
  81. *      ASPEEDW6.HPP  │  │           │               │ │                   *
  82. *      v             │  │           │               │ │                   *
  83. * AHELLOW6.CPP <─────┤  └───────────┴> AHELLOWE.RC<─┘.│. AHELLOW6.IPF     *
  84. *  ADIALOG6.CPP <────┘                  AHELLOWP.RC <─┘       │           *
  85. *   AEARTHW6.CPP                           │                  │           *
  86. *    ATIMEHDR.CPP                          │                  │           *
  87. *     ACOLORW6.CPP                         │                  │           *
  88. *      ASPEEDW6.CPP                        │                  v           *
  89. *      ║                                  rc -r             ipfc /x       *
  90. *      ║                                   │                  |           *
  91. *      v    AHELLOW6.OBJ               AHELLOWE.RES       AHELLOW6.HLP    *
  92. *  icc -c ══>ADIALOG6.OBJ               AHELLOWP.RES          .           *
  93. *             AEARTHW6.OBJ                 │                  .           *
  94. *              ATIMEHDR.OBJ                │                  .           *
  95. *               ACOLORW6.OBJ               v                  .           *
  96. *                     ║    AHELLODE.DEF->link386─>AHELLOD6.MAP.           *
  97. *                     ║     AHELLODP.DEF   │                  .           *
  98. *                     v                    │                  .           *
  99. * AHELLOW6.DEF ──>icc /Tdp─>AHELLOW6.MAP   │                  .           *
  100. *                     │                    v                  .           *
  101. *                     │                AHELLOWE.DLL . . . . . .           *
  102. *                     │                 AHELLOWP.DLL          v           *
  103. *                     └──────────────────────────────────>AHELLOW6.EXE    *
  104. *                                                                         *
  105. ***************************************************************************
  106.  
  107. ***************************************************************************
  108. *                                                       ╔═══════════╗     *
  109. * Key Window Parent Relationship Diagram:      Diagram  ║Class Name ║     *
  110. *                                                  Key: ║───────────║     *
  111. *                   IApplication::current().run()       ║Object Name║     *
  112. *                                 │                     ╚═══════════╝     *
  113. *                                 │                                       *
  114. *                           ╔════════════╗              ╔═══════════╗     *
  115. *   AColorWindow ---+-------║AHelloWindow║──────────────║ATextDialog║     *
  116. *                   |       ║────────────║              ║───────────║     *
  117. *   ASpeedWindow ---+       ║ mainWindow ║              ║textDialog ║     *
  118. *                           ╚════════════╝              ╚═══════════╝     *
  119. *                ╔════════╗       │       ╔══════╗           │            *
  120. *                ║IMenuBar║───────┼───────║ITitle║      ╔═══════════╗     *
  121. *                ║────────║       │       ╚══════╝      ║IEntryField║     *
  122. *                ║menuBar ║       │                     ║───────────║     *
  123. *                ╚════════╝       │                     ║ textField ║     *
  124. *            ╔════════════╗       │       ╔═══════════╗ ╚═══════════╝     *
  125. *            ║IAccelerator║───────┼───────║IHelpWindow║                   *
  126. *            ╚════════════╝       │       ║───────────║                   *
  127. *                                 │       ║    help   ║                   *
  128. *                                 │       ╚═══════════╝                   *
  129. *        ┌───────────────┬────────┴────────────┬─────────────────┐        *
  130. * ╔════════════╗   ╔════════════╗        ╔══════════╗        ╔═════════╗  *
  131. * ║ISplitWindow║   ║ISplitWindow║        ║ISetCanvas║        ║IInfoArea║  *
  132. * ║────────────║   ║─────────── ║        ║──────────║        ║─────────║  *
  133. * ║statusCanvas║   ║clientWindow║        ║  buttons ║        ║infoArea ║  *
  134. * ╚════════════╝   ╚════════════╝        ╚══════════╝        ╚═════════╝  *
  135. *             │          ├────────────┐         ├─────────────────┐       *
  136. *╔═══════════╗│    ╔════════════╗ ╔════════╗ ╔═══════════╗  ╔════════════╗*
  137. *║IStaticText║┤    ║ISplitWindow║ ║IListBox║ ║IPushButton║  ║IPushButton ║*
  138. *║───────────║│    ║────────────║ ║────────║ ║───────────║..║────────────║*
  139. *║ statusLine║│    ║hellowCanvas║ ║listBox ║ ║ leftButton║  ║ helpButton ║*
  140. *╚═══════════╝│    ╚════════════╝ ╚════════╝ ╚═══════════╝  ╚════════════╝*
  141. *             │          ├───────────────┐                                *      *
  142. *╔═══════════╗│    ╔═══════════╗   ╔════════════╗                         *         *
  143. *║IStaticText║┤    ║IStaticText║   ║AEarthWindow║                         *         *
  144. *║───────────║│    ║───────────║   ║────────────║                         *         *
  145. *║   date    ║│    ║   hello   ║   ║earthWindow ║                         *         *
  146. *╚═══════════╝│    ╚═══════════╝   ╚════════════╝                         *         *
  147. *             │          │                                                *
  148. *╔═══════════╗│     ╔═════════╗                                           *
  149. *║IStaticText║┘     ║IPopMenu ║                                           *
  150. *║───────────║      ╚═════════╝                                           *
  151. *║   time    ║                                                            *
  152. *╚═══════════╝                                                            *
  153. ***************************************************************************
  154.  
  155. ***************************************************************************
  156. * The HELLO6.EXE Sample Application call be build/run in three ways:      *
  157. *                                                                         *
  158. * Option 1: Run BUILD6.CMD                                                *
  159. *                                                                         *
  160. *   This option will compile, link, execute HELLO6.EXE.  It will then     *
  161. *   cleanup all files created by BUILD6.CMD.                              *
  162. *                                                                         *
  163. * Option 2: Run AMAKE6.CMD                                                *
  164. *           Run HELLO6.EXE or HELLO6 /p                                   *
  165. *           Run CLEANUP6.CMD                                              *
  166. *                                                                         *
  167. *  AMAKE6.CMD will compile and link HELLO6.EXE.                           *
  168. *  HELLO6 /p will run HELLO6 using the Portuguese Resource DLL            *
  169. *  CLEANUP6.CMD will cleanup files build by MAKE6.CMD                     *
  170. *                                                                         *
  171. * Option 3: Run AMAKE6.CMD                                                *
  172. *           Run HELLOWPS.CMD                                              *
  173. *                                                                         *
  174. *  AMAKE6.CMD will compile and link HELLO6.EXE.                           *
  175. *  HELLOWPS.CMD will create a Work Place Shell Folder with Program Objects*
  176. ***************************************************************************
  177.