home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / ICLUI.ZIP / HELLO5 / README5.TXT < prev   
Text File  |  1993-03-09  |  10KB  |  129 lines
  1. ***************************************************************************
  2. * HELLO WORLD SAMPLE PROGRAM - Version 5: Readme File (README5.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. * C++ Hello World Vision 5 Key Functions:                                 *
  16. *                                                                         *
  17. *      - Code a new control (AEarthWindow) using PM Graphics calls        *
  18. *      - Add AEarthWindow to the bottom of the client area                *
  19. *      - Add Help Windows for the Main, Dialog, Entry Field Windows       *
  20. *      - Use Split Canvas as the Client Area                              *
  21. ***************************************************************************
  22.  
  23. ***************************************************************************
  24. * File list:                                                              *
  25. *   README5.TXT  - readme file for HELLO5.EXE                             *
  26. *   AHELLOW5.CPP - source code for main() and AHelloWindow class          *
  27. *   AHELLOW5.HPP - class header file for AHellowWindow                    *
  28. *   AHELLOW5.H   - symbolic defintion file for HELLO5.EXE                 *
  29. *   ADIALOG5.CPP - source code to create the ATextDialog class            *
  30. *   ADIALOG5.HPP - class header file for ATextDialog                      *
  31. *   AEARTHW5.CPP - source code to create the AEarthWindow class           *
  32. *   AEARTHW5.HPP - class header file for AEarthWindow                     *
  33. *   AHELLOW5.RC  - resource file for HELLO5.EXE                           *
  34. *   AHELLOW5.ICO - icon file for HELLO5.EXE                               *
  35. *   ADIALOG5.DLG - dialog resource source file for HELLO5.EXE             *
  36. *   ADIALOG5.RES - dialog resource file for HELLO5.EXE                    *
  37. *   AHELLOW5.IPF - help file for HELLO5.EXE                               *
  38. *   AHELLOW5.DEF - module definition file for HELLO5.EXE                  *
  39. *   AMAKE5.MAK   - make file to create HELLO5.EXE                         *
  40. *   AMAKE5.CMD   - command file to create HELLO5.EXE                      *
  41. *   BUILD5.CMD   - command file to compile, link and run HELLO5.EXE       *
  42. *   CLEANUP5.CMD - command file to cleanup (erase) generated files:       *
  43. *                  HELLO5.EXE, AHELLOW5.OBJ, ADIALOG5.OBJ, AEARTHW5.OBJ,  *
  44. *                  AHELLOW5.MAP, AHELLOW5.HLP, AHELLOW5.ERR, AHELLOW5.RES *
  45. *                                                                         *
  46. ***************************************************************************
  47.  
  48. ***************************************************************************
  49. *                                                                         *
  50. * File Relationship Diagram (Files in Caps, Programs in lower case)       *
  51. *                                                                         *
  52. *                 AHELLOW5.H     dlgedit<->ADIALOG5.RES  iconedit         *
  53. *                    │  │           │                        │            *
  54. * AHELLOW5.HPP       │  ├───── ADIALOG5.DLG             AHELLOW5.ICO      *
  55. *  ADIALOG5.HPP      │  │           │                        │            *
  56. *   AEARTHW5.HPP     │  │           │      ┌─────────────────┘            *
  57. *      ║             │  │           │      V                              *
  58. * AHELLOW5.CPP <─────┤  └───────────┴> AHELLOW5.RC ..... AHELLOW5.IPF     *
  59. *  ADIALOG5.CPP <────┘                     |                  |           *
  60. *   AEARTHW5.CPP                          rc -r             ipfc /x       *
  61. *      ║                                   |                  |           *
  62. *      v         AHELLOW5.OBJ          AHELLOW5.RES      AHELLOW5.HLP     *
  63. *    icc -c ════> ADIALOG5.OBJ             │                  .           *
  64. *                  AEARTHW5.OBJ            │                  .           *
  65. *                     ║                    │                  .           *
  66. * AHELLOW5.DEF ──>icc /Tdp ─>AHELLOW5.MAP  │                  .           *
  67. *                     │                    v                  .           *
  68. *                  HELLO5.EXE ──────────> rc ───────────> HELLO5.EXE      *
  69. *                                                                         *
  70. ***************************************************************************
  71.  
  72. ***************************************************************************
  73. *                                                       ╔═══════════╗     *
  74. * Window Parent Relationship Diagram:          Diagram  ║Class Name ║     *
  75. *                                                  Key: ║───────────║     *
  76. *                   IApplication::current().run()       ║Object Name║     *
  77. *                                 │                     ╚═══════════╝     *
  78. *                                 │                                       *
  79. *                           ╔════════════╗              ╔═══════════╗     *
  80. *                           ║AHelloWindow║──────────────║ATextDialog║     *
  81. *                           ║────────────║              ║───────────║     *
  82. *                           ║ mainWindow ║              ║textDialog ║     *
  83. *                           ╚════════════╝              ╚═══════════╝     *
  84. *                ╔════════╗       │       ╔══════╗           │            *
  85. *                ║IMenuBar║───────┼───────║ITitle║      ╔═══════════╗     *
  86. *                ║────────║       │       ╚══════╝      ║IEntryField║     *
  87. *                ║menuBar ║       │                     ║───────────║     *
  88. *                ╚════════╝       │                     ║ textField ║     *
  89. *            ╔════════════╗       │       ╔═══════════╗ ╚═══════════╝     *
  90. *            ║IAccelerator║───────┼───────║IHelpWindow║                   *
  91. *            ╚════════════╝       │       ║───────────║                   *
  92. *                                 │       ║    help   ║                   *
  93. *                                 │       ╚═══════════╝                   *
  94. *        ┌───────────────┬────────┴────────┬───────────────────┐          *
  95. *  ╔═══════════╗   ╔════════════╗     ╔══════════╗        ╔═════════╗     *
  96. *  ║IStaticText║   ║ISplitWindow║     ║ISetCanvas║        ║IInfoArea║     *
  97. *  ║───────────║   ║─────────── ║     ║──────────║        ║─────────║     *
  98. *  ║ statusLine║   ║clientWindow║     ║  buttons ║        ║infoArea ║     *
  99. *  ╚═══════════╝   ╚════════════╝     ╚══════════╝        ╚═════════╝     *
  100. *        ┌───────────────┤                 ├──────────────────┐           *
  101.    ╔════════════╗    ╔════════╗       ╔═══════════╗    ╔════════════╗     *
  102. *  ║ISplitWindow║    ║IListBox║       ║IPushButton║    ║IPushButton ║     *
  103. *  ║────────────║    ║────────║       ║───────────║....║────────────║     *
  104. *  ║hellowCanvas║    ║listBox ║       ║ leftButton║    ║ helpButton ║     *
  105. *  ╚════════════╝    ╚════════╝       ╚═══════════╝    ╚════════════╝     *
  106. *        ├───────────────┐                                                *
  107. *  ╔═══════════╗   ╔════════════╗                                         *
  108. *  ║IStaticText║   ║AEarthWindow║                                         *
  109. *  ║───────────║   ║────────────║                                         *
  110. *  ║   hello   ║   ║earthWindow ║                                         *
  111. *  ╚═══════════╝   ╚════════════╝                                         *
  112. ***************************************************************************
  113.  
  114. ***************************************************************************
  115. * The HELLO5.EXE Sample Application call be build in two ways:            *
  116. *                                                                         *
  117. * Option 1: Run BUILD5.CMD                                                *
  118. *                                                                         *
  119. *   This option will compile, link, execute HELLO5.EXE.  It will then     *
  120. *   cleanup all files created by BUILD5.CMD.                              *
  121. *                                                                         *
  122. * Option 2: Run AMAKE5.CMD                                                *
  123. *           Run HELLO5.EXE                                                *
  124. *           Run CLEANUP5.CMD                                              *
  125. *                                                                         *
  126. *   AMAKE5.CMD will compile and link HELLO5.EXE.                          *
  127. *   CLEANUP5.CMD will cleanup files build by MAKE5.CMD                    *
  128. ***************************************************************************
  129.