home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD2.mdf / c / library / os2 / mdi / read.me < prev    next >
Encoding:
Text File  |  1990-03-09  |  4.6 KB  |  129 lines
  1. San Francisco Canyon Comapny
  2. 2237 Union Street
  3. San Francisco, CA 94123
  4.  
  5. (415) 441-2745  -  FAX 441-2513
  6.  
  7. Compuserve 72371,104
  8.  
  9. Mark Florence, President
  10.  
  11.  
  12.  
  13. MDI DLL
  14. -------
  15. You have just downloaded a set of tools that make writing MDI applications
  16. under OS/2 PM extemely simple. MDI.DLL does all the work (a couple of
  17. small "helper" DLLs assist). MDI.H, which must be included in all
  18. programs that use MDI, defines the API. Two sample programs, one very
  19. basic and one more useful, illustrate how to use the small number
  20. of messages and functions defined.
  21.  
  22. The MDI DLL was developed by the San Francisco Canyon Company for
  23. internal use. If you like what you see and you find it useful, please
  24. send $25 to Canyon. In return, we'll send you printed documentation
  25. (only the most basic documentation is included here), a
  26. QuickHelp database for the MDI messages and function calls and we'll
  27. keep you up-to-date with fixes and changes. Of course, any suggestions
  28. or problem reports will be gratefully received.
  29.  
  30. Good luck!
  31.  
  32. Highlights
  33. ----------
  34.  
  35.   * details of the MDI user interface are completely handled
  36.  
  37.   * a "desktop" window maintains the basic MDI interface
  38.  
  39.   * multiple "document" windows can be opened within the "desktop"
  40.  
  41.   * the title of each "document" is automatically maintained.
  42.     Documents of the same name are automatically assigned a ":n"
  43.     suffix.
  44.  
  45.   * a "window" menu entry is automatically created and maintained
  46.     within the "desktop" menu bar
  47.  
  48.   * the system menu for "document" windows is automatically altered
  49.     for the MDI accelerator conventions
  50.  
  51.   * the positions of the "desktop" and "document" windows are
  52.     automatically remembered by name on OS2.INI
  53.  
  54.   * a re-entrant data area can be automatically created for the
  55.     "desktop" window
  56.  
  57.   * a re-entrant data area (document instance data) can be automatically
  58.     created for each "document" window. This can be used, for example,
  59.     to maintain positioning within a document.
  60.  
  61.   * a re-entrant data area (document data) can be automatically created
  62.     for each like-named document (ignoring any ":n" sufix). This can be
  63.     used, for example, to maintain the contents of the document.
  64.  
  65.   * simple messages return the locations of the re-entrant data areas
  66.  
  67. Restrictions
  68. ------------
  69. Note: refer to the sample programs (TEST.C and BROWSER.C) for
  70. clarification of these points.
  71.  
  72.   * your desktop and document window procedures (as named in the
  73.     MDICreateDesktop and MDICreateDocument calls) cannot process
  74.     the WM_CREATE or WM_DESTROY messages. Instead, they can process
  75.     the MDI_NOTIFY_* messages documented in MDI.H.
  76.  
  77.   * all messages must be passed to MDIDesktopWndProc or
  78.     MDIDocumentWndProc as appropriate. This includes WM_COMMAND
  79.     or WM_CONTROL messages
  80.  
  81.   * currently, MDI.DLL reserves the values 32000-32767 as the command
  82.     value in WM_COMMAND messages. This means, for example, that you
  83.     can't use this range as menu ids. This restriction is expected
  84.     to be removed in a future release.
  85.  
  86. MDI.ARC Contents
  87. ----------------
  88. MDI.ARC contains the source and executables for these components:
  89.  
  90.   TELLUSER.DLL : Internal user notification DLL
  91.   ALLOCMEM.DLL : Internal memory management DLL
  92.   MDI.DLL      : MDI User Interface DLL
  93.   TEST.EXE     : Basic MDI test program
  94.   BROWSER.EXE  : Basic MDI file Browser
  95.  
  96. In addition, these files are provided to help you get started immediately
  97. with the MDI interface. You may already have them installed on your system.
  98.  
  99.   CRTLIB.DLL   : Reentrant C functions DLL
  100.   CRTLIB.LIB   : Reentrant C functions LIB
  101.   CRTEXE.OBJ   : Reentrant C start-up code for EXE
  102.   CRTLIB.OBJ   : Reentrant C start-up code for DLL
  103.   OPENDLG.DLL  : Open Dialog Box DLL (from Tool Kit samples --
  104.                  used only by the file Browser)
  105.  
  106. Installation
  107. ------------
  108. To install the executables, copy the DLLs to a directory referenced by
  109. LIBPATH. Execute TEST to see a basic demonstration of the capabilities
  110. of the MDI interface. Execute BROWSER to see a more comprehensive (and
  111. useful!) example.
  112.  
  113. Note: the executables were compiled with the 1.2 bindings; they
  114. may need to be re-compiled with the 1.1 bindings in order to run under 1.1.
  115.  
  116. Compilation
  117. -----------
  118. If you need to recompile the MDI interface, edit the following files to
  119. suit your configuration:
  120.  
  121.   COMPILE.CMD  : Compile batch file
  122.   TELLUSER     : Internal user notification DLL MAKE file
  123.   ALLOCMEM     : Internal memory management DLL MAKE file
  124.   MDI          : Internal MDI User interface DLL MAKE file
  125.   TEST         : Test program MAKE file
  126.   BROWSER      : Browser program MAKE file
  127.  
  128. Then, run COMPILE.CMD.
  129.