home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / ibmodf.zip / READ.ME < prev    next >
Text File  |  1995-06-14  |  5KB  |  96 lines
  1. The IBM OpenDoc Forms Framework   - SWS at RTP Lab, Research Triangle Park, NC
  2.                                     Development contact: Art Jolin
  3. ---------------------------------------------------------------
  4.  
  5. This alpha3 driver works with the SOM OpenDoc DEVCON7 level and the BETA2 version of VisualAge C++ 3.0
  6. (the product formerly known as CSet++). NOTE: This driver will not work with VA C++ 3.0 GA because
  7. of a class name change (IPart became IStandardNotifier). A new driver will be available 
  8. shortly after 3.0 GA time.
  9.  
  10. NEW IN DRIVER ALPHA3:
  11. * Major change in model/view design and synchronization. Model now uses
  12. IStandardNotifier-derived model content objects of any design you choose,
  13. not just I*Field objects. Model content data and view controls are synched
  14. using connection objects (1 base flavor now, more later).
  15.  
  16.  
  17. These are the files you should have:
  18.  
  19. READ.ME        - this file
  20.  
  21. /* temporary addition, until OpenDoc .HH files are up to snuff...*/
  22. OPEND_HH.ZIP   - contents of OPENDOC/HH, with our mods to fix various things. These
  23.                  must appear in your include path before OPENDOC\HH
  24.  
  25. DDE4CPP.EXE -   Fix to VisualAge C++ BETA2 compiler needed for DTS compilation. 
  26.                 Use this until the VA C++ GA comes out. Overlay old file in CPPBETA\BIN
  27.  
  28. ODFBIN.ZIP     - various binarys you need. 
  29.                  The .DLL for the OD Framework, and a sample framework part's .DLL.
  30.                  Also includes a replacement CNTNRPRT.DLL; you may wish to rename your
  31.                  old one just in case you may need to get back to it (without rebuilding).         
  32.                  Put the contents of this ZIP file in the BIN subdirectory.  
  33.  
  34. CNTNRPRT.ZIP      modified container part source. Use this if you have made your
  35.                   own mods to container part, to merge our changes and yours.
  36.                   If you use the stock container part today, you don't even have
  37.                   to unzip this file; the proper dll is in ODFBIN.ZIP.
  38.  
  39. SIMPLPRT.ZIP      modified SimplePart source. Use this if you have made your
  40.                   own mods to SimplePart part, to merge our changes and yours.
  41.                   If you use the stock SimplePart today, you don't even have
  42.                   to unzip this file; the proper stuff was linked into the framework.
  43.  
  44. ODFRK.ZIP         the framework headers. Put these under the OPENDOC
  45.                        directory, as OPENDOC\ODFRK. There is one lib, 
  46.                        put it in the LIB subdirectory.                      
  47.  
  48. CUSTOMER.ZIP   a sample part based on the framework. Put these under the OPENDOC  
  49.                        PARTS directory, as PARTS\CUSTOMER directory. You can dup
  50.                        these files to make your own parts derived from ODFModel et al.
  51.  
  52. ODFRDSGN.INF - online version of the design approach. Use like a toy users guide
  53. ODFRKREF.INF - online version of reference for classes implemented thus far.
  54.  
  55. ------------
  56. Known restrictions are:      
  57.  
  58. Of course, as an early alpha this is of very limited function. See reference for 
  59. what we have implemented so far.                       
  60.                                                                                                                                                  
  61. IField and derived objects are undergoing major change. Use of them as they were encourages
  62. an OO design where your objects are too fine-grained. The neat built-in behavior of
  63. these classes may resurface in a later driver as intelligent connection classes. 
  64. The IField classes will likely resurface
  65. purely as primitive model content objects, useful only when you must build your
  66. model content at runtime from data whose format is unknown at code development time;
  67. e.g., you do an database query (without DAX) and get back data plus info on the types
  68. of the data, and it could be any of the primitive C datatypes.
  69. This is an unusual situation, but does occur; opinions on the usefulness of this
  70. design notion are appreciated.
  71.                                                                          
  72. NOTE: on model/view synchronization on focusChange, note that if you click on
  73. another OpenDoc part that does not ask for the focus, no synch takes place.
  74. Since keyboard focus is still on the original part, I think this is as it should be.
  75. Comments?
  76.  
  77. No support yet in the framework for persistance. The custpart sample does show
  78. a simple example of how you can use the underlying OD toolkit to do some
  79. simple persistance, for now.
  80.  
  81. No support yet for menus (you must use underlying OpenDoc toolkit for now)
  82.  
  83. No support yet for semantic events and scripting. 
  84.  
  85. No support yet for embedding other parts in a ODFramework part.
  86.  
  87. Scrollbars "hang around" after you move a frame. Some odd PM/OPENDOC bug.                          
  88.  
  89. Container part RequestEmbeddedFrame was changed. See new source.
  90.  
  91. SimplePart (in smartprt directory): prtinfo.hpp was modified. See new source.
  92.  
  93. Probably lots of other things we haven't seen yet.
  94.  
  95. Watch for updates...  
  96. Cheers and thanks for the patience.