home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / igpb1.zip / README4.TXT < prev   
Text File  |  1994-03-11  |  9KB  |  131 lines
  1. ***************************************************************************
  2. * HELLO WORLD SAMPLE PROGRAM - Special version with IGraphicPushButtons   *
  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. *  Additions on 4/11/94 for a special version:
  26. *      change push buttons to IGraphicPushButtons
  27. *      igpbrdr.hpp added. This is a Resize Handler that allows you to
  28. *         change the size of the border around the graphic on an
  29. *         IGraphicPushButton.
  30. ***************************************************************************
  31.  
  32. ***************************************************************************
  33. * File list:                                                              *
  34.  
  35. *   igpbrdr.hpp  - resize handler for controlling size of border around
  36. *                  IGraphicPushButtons. This file is meant to be reusable
  37. *                  with any program.
  38. *
  39. *   README4.TXT  - readme file for HELLO4.EXE                             *
  40. *   AHELLOW4.CPP - source code for main() and AHelloWindow class          *
  41. *   AHELLOW4.HPP - class header file for AHellowWindow                    *
  42. *   AHELLOW4.H   - symbolic defintion file for HELLO4.EXE                 *
  43. *   ADIALOG4.CPP - source code to create the ATextDialog class            *
  44. *   ADIALOG4.HPP - class header file for ATextDialog                      *
  45. *   AHELLOW4.RC  - resource file for HELLO4.EXE                           *
  46. *   AHELLOW4.ICO - icon file for HELLO4.EXE                               *
  47. *   ADIALOG4.DLG - dialog resource source file for HELLO4.EXE             *
  48. *   ADIALOG4.RES - dialog resource file for HELLO4.EXE                    *
  49. *   AHELLOW4.DEF - module definition file for HELLO4.EXE                  *
  50. *   AMAKE4.MAK   - make file to create HELLO4.EXE                         *
  51. *   AMAKE4.CMD   - command file to create HELLO4.EXE                      *
  52. *   BUILD4.CMD   - command file to compile, link and run HELLO4.EXE       *
  53. *   CLEANUP4.CMD - command file to cleanup (erase) generated files:       *
  54. *                  HELLO4.EXE, AHELLOW4.OBJ, ADIALOG4.OBJ, AEARTHW4.OBJ,  *
  55. *                  AHELLOW4.MAP, AHELLOW4.ERR, AHELLOW4.RES               *
  56. ***************************************************************************
  57.  
  58. ***************************************************************************
  59. * File Relationship Diagram (Files in uppercase, Programs in lowercase)   *
  60. *                                                                         *
  61. *                 AHELLOW4.H     dlgedit<──>ADIALOG4.RES     iconedit     *
  62. *                    │  │           │                           │         *
  63. * AHELLOW4.HPP       │  ├───── ADIALOG4.DLG                AHELLOW4.ICO   *
  64. *  ADIALOG4.HPP      │  │           │                           │         *
  65. *      ║             │  │           │                           │         *
  66. *      v             │  │           │                           │         *
  67. * AHELLOW4.CPP <─────┤  └───────────┴─>AHELLOW4.RC<─────────────┘         *
  68. *  ADIALOG4.CPP <────┘                     │                              *
  69. *      ║                                  rc -r                           *
  70. *      ║                                   │                              *
  71. *      v         AHELLOW4.OBJ          AHELLOW4.RES                       *
  72. *    icc -c ════> ADIALOG4.OBJ             │                              *
  73. *                     ║                    │                              *
  74. *                     ║                    │                              *
  75. * AHELLOW4.DEF ──>icc /Tdp ─>AHELLOW4.MAP  │                              *
  76. *                     │                    v                              *
  77. *                  HELLO4.EXE ──────────> rc ───────────> HELLO4.EXE      *
  78. ***************************************************************************
  79.  
  80. ***************************************************************************
  81. *                                                       ╔═══════════╗     *
  82. * Window Parent Relationship Diagram:          Diagram  ║Class Name ║     *
  83. *                                                  Key: ║───────────║     *
  84. *                   IApplication::current().run()       ║Object Name║     *
  85. *                                                       ╚═══════════╝     *
  86. *                                                                         *
  87. *                           ╔════════════╗              ╔═══════════╗     *
  88. *                           ║AHelloWindow║──────────────║ATextDialog║     *
  89. *                           ║────────────║              ║───────────║     *
  90. *                           ║ mainWindow ║              ║textDialog ║     *
  91. *                           ╚════════════╝              ╚═══════════╝     *
  92. *                ╔════════╗       │           ╔══════╗       │            *
  93. *                ║IMenuBar║───────┼────────── ║ITitle║  ╔═══════════╗     *
  94. *                ║────────║       │           ╚══════╝  ║IEntryField║     *
  95. *                ║menuBar ║       │                     ║───────────║     *
  96. *                ╚════════╝       │                     ║ textField ║     *
  97. *                                 │                     ╚═══════════╝     *
  98. *          ╔════════════╗         │                                       *
  99. *          ║IAccelerator║─────────┤                                       *
  100. *          ╚════════════╝         │                                       *
  101. *                                 │                                       *
  102. *        ┌───────────────┬────────┴────────┬───────────────────┐          *
  103. *  ╔═══════════╗   ╔═══════════╗      ╔══════════╗        ╔═════════╗     *
  104. *  ║IStaticText║   ║IStaticText║      ║ISetCanvas║        ║IInfoArea║     *
  105. *  ║───────────║   ║───────────║      ║          ║        ║─────────║     *
  106. *  ║ statusLine║   ║   hello   ║      ║  buttons ║        ║infoArea ║     *
  107. *  ╚═══════════╝   ╚═══════════╝      ╚══════════╝        ╚═════════╝     *
  108. *                 (Client Window)   ┌──────┴─────────┐                    *
  109. *                             ╔═══════════╗    ╔════════════╗             *
  110. *                             ║IPushButton║    ║IPushButton ║             *
  111. *                             ║───────────║....║────────────║             *
  112. *                             ║ leftButton║    ║ rightButton║             *
  113. *                             ╚═══════════╝    ╚════════════╝             *
  114. ***************************************************************************
  115.  
  116. ***************************************************************************
  117. * The HELLO4.EXE Sample Application call be build in two ways:            *
  118. *                                                                         *
  119. * Option 1: Run BUILD4.CMD                                                *
  120. *                                                                         *
  121. *   This option will compile, link, execute HELLO4.EXE.  It will then     *
  122. *   cleanup all files created by BUILD4.CMD.                              *
  123. *                                                                         *
  124. * Option 2: Run AMAKE4.CMD                                                *
  125. *           Run HELLO4.EXE                                                *
  126. *           Run CLEANUP4.CMD                                              *
  127. *                                                                         *
  128. *   AMAKE4.CMD will compile and link HELLO4.EXE.                          *
  129. *   CLEANUP4.CMD will cleanup files build by AMAKE4.CMD                   *
  130. ***************************************************************************
  131.