home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / cset21v1.zip / IBMCPP / SAMPLES / ICLUI / HELLO4 / README4.TXT < prev   
Text File  |  1993-10-18  |  9KB  |  120 lines
  1. ***************************************************************************
  2. * HELLO WORLD SAMPLE PROGRAM - Version 4: Readme File (README4.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. * See the User Interface Class Library Users Guide for more information   *
  16. *   about this sample program.                                            *
  17. *                                                                         *
  18. * C++ Hello World Vision 4 Key Functions:                                 *
  19. *    - Add Accelerator Keys for Left (F7), Center(F8), Right(F9)          *
  20. *    - Modify Left, Center and Right Menu Items to show function key      *
  21. *    - Modify Menu Bar to create Edit Menu and "text..." Menu Item        *
  22. *    - Add ADialogText to allow user to change "Hello, World" text        *
  23. *    - Add Push Buttons & Set Canvas to change alignment                  *
  24. ***************************************************************************
  25.  
  26. ***************************************************************************
  27. * File list:                                                              *
  28. *   README4.TXT  - readme file for HELLO4.EXE                             *
  29. *   AHELLOW4.CPP - source code for main() and AHelloWindow class          *
  30. *   AHELLOW4.HPP - class header file for AHellowWindow                    *
  31. *   AHELLOW4.H   - symbolic defintion file for HELLO4.EXE                 *
  32. *   ADIALOG4.CPP - source code to create the ATextDialog class            *
  33. *   ADIALOG4.HPP - class header file for ATextDialog                      *
  34. *   AHELLOW4.RC  - resource file for HELLO4.EXE                           *
  35. *   AHELLOW4.ICO - icon file for HELLO4.EXE                               *
  36. *   ADIALOG4.DLG - dialog resource source file for HELLO4.EXE             *
  37. *   ADIALOG4.RES - dialog resource file for HELLO4.EXE                    *
  38. *   AHELLOW4.DEF - module definition file for HELLO4.EXE                  *
  39. *   AMAKE4.MAK   - make file to create HELLO4.EXE                         *
  40. *   AMAKE4.CMD   - command file to create HELLO4.EXE                      *
  41. *   BUILD4.CMD   - command file to compile, link and run HELLO4.EXE       *
  42. *   CLEANUP4.CMD - command file to cleanup (erase) generated files:       *
  43. *                  HELLO4.EXE, AHELLOW4.OBJ, ADIALOG4.OBJ, AEARTHW4.OBJ,  *
  44. *                  AHELLOW4.MAP, AHELLOW4.ERR, AHELLOW4.RES               *
  45. ***************************************************************************
  46.  
  47. ***************************************************************************
  48. * File Relationship Diagram (Files in uppercase, Programs in lowercase)   *
  49. *                                                                         *
  50. *                 AHELLOW4.H     dlgedit<──>ADIALOG4.RES     iconedit     *
  51. *                    │  │           │                           │         *
  52. * AHELLOW4.HPP       │  ├───── ADIALOG4.DLG                AHELLOW4.ICO   *
  53. *  ADIALOG4.HPP      │  │           │                           │         *
  54. *      ║             │  │           │                           │         *
  55. *      v             │  │           │                           │         *
  56. * AHELLOW4.CPP <─────┤  └───────────┴─>AHELLOW4.RC<─────────────┘         *
  57. *  ADIALOG4.CPP <────┘                     │                              *
  58. *      ║                                  rc -r                           *
  59. *      ║                                   │                              *
  60. *      v         AHELLOW4.OBJ          AHELLOW4.RES                       *
  61. *    icc -c ════> ADIALOG4.OBJ             │                              *
  62. *                     ║                    │                              *
  63. *                     ║                    │                              *
  64. * AHELLOW4.DEF ──>icc /Tdp ─>AHELLOW4.MAP  │                              *
  65. *                     │                    v                              *
  66. *                  HELLO4.EXE ──────────> rc ───────────> HELLO4.EXE      *
  67. ***************************************************************************
  68.  
  69. ***************************************************************************
  70. *                                                       ╔═══════════╗     *
  71. * Window Parent Relationship Diagram:          Diagram  ║Class Name ║     *
  72. *                                                  Key: ║───────────║     *
  73. *                   IApplication::current().run()       ║Object Name║     *
  74. *                                                       ╚═══════════╝     *
  75. *                                                                         *
  76. *                           ╔════════════╗              ╔═══════════╗     *
  77. *                           ║AHelloWindow║──────────────║ATextDialog║     *
  78. *                           ║────────────║              ║───────────║     *
  79. *                           ║ mainWindow ║              ║textDialog ║     *
  80. *                           ╚════════════╝              ╚═══════════╝     *
  81. *                ╔════════╗       │           ╔══════╗       │            *
  82. *                ║IMenuBar║───────┼────────── ║ITitle║  ╔═══════════╗     *
  83. *                ║────────║       │           ╚══════╝  ║IEntryField║     *
  84. *                ║menuBar ║       │                     ║───────────║     *
  85. *                ╚════════╝       │                     ║ textField ║     *
  86. *                                 │                     ╚═══════════╝     *
  87. *          ╔════════════╗         │                                       *
  88. *          ║IAccelerator║─────────┤                                       *
  89. *          ╚════════════╝         │                                       *
  90. *                                 │                                       *
  91. *        ┌───────────────┬────────┴────────┬───────────────────┐          *
  92. *  ╔═══════════╗   ╔═══════════╗      ╔══════════╗        ╔═════════╗     *
  93. *  ║IStaticText║   ║IStaticText║      ║ISetCanvas║        ║IInfoArea║     *
  94. *  ║───────────║   ║───────────║      ║          ║        ║─────────║     *
  95. *  ║ statusLine║   ║   hello   ║      ║  buttons ║        ║infoArea ║     *
  96. *  ╚═══════════╝   ╚═══════════╝      ╚══════════╝        ╚═════════╝     *
  97. *                 (Client Window)   ┌──────┴─────────┐                    *
  98. *                             ╔═══════════╗    ╔════════════╗             *
  99. *                             ║IPushButton║    ║IPushButton ║             *
  100. *                             ║───────────║....║────────────║             *
  101. *                             ║ leftButton║    ║ rightButton║             *
  102. *                             ╚═══════════╝    ╚════════════╝             *
  103. ***************************************************************************
  104.  
  105. ***************************************************************************
  106. * The HELLO4.EXE Sample Application call be build in two ways:            *
  107. *                                                                         *
  108. * Option 1: Run BUILD4.CMD                                                *
  109. *                                                                         *
  110. *   This option will compile, link, execute HELLO4.EXE.  It will then     *
  111. *   cleanup all files created by BUILD4.CMD.                              *
  112. *                                                                         *
  113. * Option 2: Run AMAKE4.CMD                                                *
  114. *           Run HELLO4.EXE                                                *
  115. *           Run CLEANUP4.CMD                                              *
  116. *                                                                         *
  117. *   AMAKE4.CMD will compile and link HELLO4.EXE.                          *
  118. *   CLEANUP4.CMD will cleanup files build by AMAKE4.CMD                   *
  119. ***************************************************************************
  120.