home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / sompar.zip / README.TXT < prev    next >
Text File  |  1994-01-10  |  7KB  |  130 lines
  1. README for SOMPARTS.ZIP - Parts Like Toolbar and SOMObject Demo          v1.00
  2. ----------------------------------------------------------------------------
  3.  
  4. This is C++ IBM User Interface Class Library demo of a simple application 
  5. that demostrates using SOMObject's Distribute Objects inside a application
  6. written in IBM User Interface Class Library. The main purpose of this 
  7. sample code is demostrated how a simple SOMObjects DSOM object can be 
  8. intergrated into a GUI C++ application using the class libraries.
  9.  
  10. This demo includes source code for both the application SOMPARTS.EXE and 
  11. the DSOM  PART object...  To execute this program you must have both the
  12. CSet++ 2.1 runtimes and the SOM 2.0 runtines loaded on your system
  13.  
  14. The following is a brief layout of the files included in this demo
  15.  
  16.  SOMPARTS.EXE - Sample C++ DSOM Client Application
  17. ---------------------------------------------------------------------------
  18. SOMPARTS.HPP    - Header file for main application and main window
  19. SOMPARTS.CPP   - main source module for main application and its window
  20. SOMPARTS.H     - #defines for main applications
  21. SOMPARTS.RC    - resource file for main application
  22. SOMPARTS.DEF   - DEF file for main application
  23. PARTS.HPP        - Header file for Parts Like Notebook Toolbar
  24. PARTS.CPP      - Source file for Parts like Notebook Toolbar, uses the new
  25.                       Graphical Bitmap buttons in CSet++ 2.1. This note book is
  26.                       use to create new PART DSOM objects.  This notebook is use
  27.                       in combination with bitmaps to created a toolbar similar 
  28.                       to what is included with Digitalks Parts product.
  29. SETPAGES.HPP   - Header for the pages in Notebook 
  30. SETPAGES.CPP   - Source file for pages in Notebook, including base class 
  31.                       for all four pages, each page inherited this class.
  32. LISTBOX.HPP    - Header for the listbox dialog window
  33. LISTBOX.CPP    - Source file for the listbox dialog window, this window 
  34.                       setups a timer and updates the dialog's list box with 
  35.                       new actions that the user selects from Notebook toolbar
  36. SOMACT.HPP     - Header    for SomAction wrapper around the Part DSOM Object
  37. SOMACT.CPP     - Source file for SomAction wrapper around the Part DSOM
  38.                       Object... all SOMObject's code is place in this module
  39.                       for client. Also contains a collection class library
  40.                       stack to hold modified items                
  41. INFODLG.HPP    - Header file for Information Dialog class
  42. INFODLG.CPP    - Source file for Information dialog class, this is generic
  43.                       wrapper around resource file dialogs that only need to
  44.                       handle OK and CANCEL buttons
  45.  
  46. Also required for compiling SOMPARTS.EXE
  47.  
  48. ATIMEHDR.HPP   - Header file from IUCL sample #6 provided with CSet++ 2.1
  49. ATIMEHDR.CPP   - Source file from IUCL sample #6 provided with CSet++ 2.1
  50.                       This file basic handle a timer event that use by listbox.cpp
  51.     
  52.  
  53.  
  54.  PARTS.DLL - SOMObjects 2.0 DSOM DLL
  55. ---------------------------------------------------------------------------
  56.  
  57. CLIENT.CPP         - Non GUI Test program for PART DSOM Object
  58.  
  59. INITTERM.C        - DLL Initialization and termination logic
  60. PART.C             - Main DSOM Dll source code for Part object
  61. PART.DEF        - DEF file for Part.dll
  62. PART.H          - Header file for Part.dll
  63. PART.IDL        - IDL for Part.dll
  64. PART.IH             - Implemention header file for Part.dll
  65. PART.LNK          - Link file for Part.dll
  66. PART.XH             - C++ client header for Part.dll DSOM object
  67.  
  68.  
  69. SomAction class designed:
  70.  
  71. The SomAction class is designed as a wrapper arround the DSOM object methods
  72. that I created.  I designed the class in such a way that when the class is
  73. allocated during the contructor that SOM and DSOM environments are created 
  74. and the Part object is created.  When the destructor is freed, so are Part
  75. object and the SOM and DSOM enviroments
  76.  
  77. SomAction class is allocated in the main window class (PartsWindow) and is 
  78. past onto to the Part likes Notebook class (PartsNoteTool) and the listbox
  79. class (PartListBox)
  80.  
  81. ---------------------------------------------------------------------------- 
  82. Creation of this sample program.
  83.  
  84. 1.  1st you need to designed the IDL file and let the SOM compiler generated
  85.     the basic code for the DSOM server DLL and its associated header
  86. 2.  Fill in specifics for DSOM dll and created a simple non GUI client 
  87.     application to test the DSOM dll
  88. 3.  Using KASE:Set prototyper provided with CSet++ 2.1, Prototype and 
  89.     Generate a basic outline for main window, Notebook and the listbox 
  90.     dialogs.
  91. 4.  The Generated code was then modified, documented and enhanced. Notebook
  92.     was change into a single source file which interits a base class for 
  93.      each page since each page is similar in designed and appearence.
  94. 5.  Modified Notebook to use new graphical buttens provided with CSet++ 2.1
  95. 6.  Create the SomAction wrapper class arround the DSOM Object.. this is done
  96.     so that it communication to the DSOM object can be done by a simple 
  97.     C++ class library.  This removes the necessary that any other module 
  98.     needs to know about the details of DSOM Som object.
  99. 7.  Modied main window, note book and pages, and  the listbox functions so
  100.     that they can communicate with SomAction class.. a single Object is
  101.     created at beginning and destroy when program is finish.
  102. 8.  Added logic to Notebook to update edit fields butten is pressed
  103. 9.  Added logic to notebook to process SomAction - if this is a new object 
  104.     it will be flag as new, otherwise count is incremented
  105. 10. Added logic to listbox, so on ever tick (by inherited ATimeHandler class
  106.     provide with Sample #6 provide with CSet++) will check to see if object
  107.     has been process. If object it was process, information is filed in
  108.     dialogs fields
  109. 11. I created a generic InfoDialog class that can be use to create simple 
  110.     dialogs that resource are in the resource file instead of being in
  111.     canvas.
  112.  
  113.  
  114. ---------------------------------------------------------------------------- 
  115. Future plans...
  116.  
  117. I planned to create more sample programs which combines the IBM User 
  118. Interface Class Libraries and SOMObjects.  Including a Persistent DSOM
  119. server use in connection with Containers with new Drag and Drop features 
  120. included with CSet++ 2.1.  Also I planned to investigated Workplace Shell
  121. intergrating with IBM User Interface Class Libraries and also multithreading.
  122.  
  123. ---------------------------------------------------------------------------- 
  124.  
  125. Stewart Hyde
  126. CIS:     71034,3712
  127. GEnie:   S.HYDE       Asst Sysop OS/2 RT
  128.  
  129.  
  130.