home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 7 / 07.iso / c / c082_122 / 7.ddi / OWLDOC.ZIP / OWL31.DOC < prev    next >
Encoding:
Text File  |  1992-06-10  |  8.4 KB  |  228 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7. ===========================================================================
  8. ObjectWindows and Windows 3.1
  9. ===========================================================================
  10.  
  11.                     ObjectWindows has been greatly enhanced to support
  12.                     changes in Windows 3.1. Here's a summary of those
  13.                     changes:
  14.  
  15.                     o The ObjectWindows DLL has been renamed OWL31.DLL, to
  16.                       avoid incompatibilities with older versions. Note
  17.                       that the import library is still named OWL.LIB, so
  18.                       you don't have to change your current makefiles,
  19.                       projects, or .DEF files to use the new .DLL name.
  20.  
  21.                     o GetClassName in the following classes now returns new
  22.                       class names, for compatibility with older versions of
  23.                       OWL.DLL:
  24.  
  25.                       TDialog
  26.                       TMDIFrame
  27.                       TWindow
  28.  
  29.                     o ObjectWindows applications and ObjectWindows itself
  30.                       can be built in several new variations:
  31.  
  32.                       - with full backward compatibility with Borland C++
  33.                         3.0 and Turbo C++ for Windows 3.0. (See "Backward
  34.                         compatibility: Using all your existing code,"
  35.                         below.) When using this option, your ObjectWindows
  36.                         applications will run under both Windows 3.0 and
  37.                         3.1.
  38.  
  39.                       - for full compatibility with Windows 3.1. (See
  40.                         "Windows 3.1 compatibility," below.) When you use
  41.                         this option, you can use the new features of
  42.                         Windows 3.1 (like multimedia and TrueType).
  43.  
  44.                       - for Windows 3.1's new Strict code style. (See
  45.                         "Strict compatibility," below.) Strict is a new set
  46.                         of macros and types that help you catch common
  47.                         ObjectWindows programming errors when you compile
  48.                         your applications, rather than waiting for bugs and
  49.                         crashes to happen when you run them.
  50.  
  51.                     o ObjectWindows is no longer supported in the Compact
  52.                       memory model.
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.                     If you have Borland C++ 3.1, you can also its other new
  60.                     features like 80386 code generation, the Object Data
  61.                     calling convention, and the Borland Resource Compiler
  62.                     and Resource Linker. Naturally, you can also use
  63.                     features from Borland C++ 3.0, like global
  64.                     optimizations, too.
  65.  
  66.  
  67.           Backward  =======================================================
  68.     compatibility:
  69.     Using all your  This version of ObjectWindows contains the classes and
  70.      existing code  members to be compatible with Borland C++ 3.0 and Turbo
  71.                     C++ for Windows 3.0. All the code you've written that
  72.                     calls ObjectWindows member functions will still compile
  73.                     and run fine.
  74.  
  75.                     All you have to do to use this option is to define the
  76.                     macro WIN30 before you include the owl.h header file.
  77.                     There are three ways to do this:
  78.  
  79.                     o If you use the Borland C++ command-line compiler, add
  80.                       "-DWIN30" (without the quotes) to the beginning of
  81.                       your command line. For example, you might compile a
  82.                       module like this:
  83.  
  84.                       BCC -WE -DWIN30 myprog.cpp owlws.lib tclasss.lib
  85.  
  86.                     o If you use any of the IDEs, add "WIN30" (without the
  87.                       quotes) to the Options|Compiler|Code Generation|
  88.                       Defines input box. For example, if you already define
  89.                       a macro DEBUG in this input box, adding WIN30 would
  90.                       look like this:
  91.  
  92.                       DEBUG;WIN30
  93.  
  94.                     o You can also add "#define WIN30" in your source code
  95.                       before you include owl.h. For example,
  96.  
  97.                       ...
  98.                       #define WIN30
  99.                       #include <owl.h>
  100.                       ...
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.                                    - 2 -
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.        Windows 3.1  =======================================================
  118.      compatibility
  119.                     ObjectWindows is also fully compatible with Windows 3.1
  120.                     and the Windows 3.1 windows.h header file. Using this
  121.                     option lets you use new Windows 3.1 features like
  122.                     multimedia. Note that although Windows 3.0 applications
  123.                     run under Windows 3.1 without change, changes to the
  124.                     Windows 3.1 windows.h header file do require some
  125.                     changes to your code. Many Windows API functions now
  126.                     take slightly different argument types. Converting your
  127.                     code to those new argument types is quite simple; for
  128.                     more details, see the online Help API reference and the
  129.                     online document WIN31.DOC.
  130.  
  131.                     As when you use the WIN30 macro, all you have to do to
  132.                     use this option is to define the macro WIN31 before you
  133.                     include the owl.h header file. There are three ways to
  134.                     do this:
  135.  
  136.                     o If you use the Borland C++ command-line compiler, add
  137.                       "-DWIN31" (without the quotes) to the beginning of
  138.                       your command line. For example, you might compile a
  139.                       module like this:
  140.  
  141.                       BCC -WE -DWIN31 myprog.cpp owlws.lib tclasss.lib
  142.  
  143.                     o If you use any of the IDEs, add "WIN31" (without the
  144.                       quotes) to the Options|Compiler|Code Generation|
  145.                       Defines input box. For example, if you already define
  146.                       a macro DEBUG in this input box, adding WIN31 would
  147.                       look like this:
  148.  
  149.                       DEBUG;WIN31
  150.  
  151.                     o You can also add "#define WIN31" in your source code
  152.                       before you include owl.h. For example,
  153.  
  154.                       ...
  155.                       #define WIN31
  156.                       #include <owl.h>
  157.                       ...
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.                                    - 3 -
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.             Strict  =======================================================
  176.      compatibility
  177.                     ObjectWindows is also Strict-compliant; the advantages
  178.                     you get when using Strict are well worth the changes
  179.                     you need to make in your code. We do recommend that you
  180.                     start converting your code to Strict. For details about
  181.                     Strict, see the online document WIN31.DOC.
  182.  
  183.                     Note that you must use the WIN31 macro to use Strict.
  184.                     The macro you need to define is STRICT. The three ways
  185.                     to define these macros:
  186.  
  187.                     o If you use the Borland C++ command-line compiler, add
  188.                       "-DWIN31;STRICT" (without the quotes) to the
  189.                       beginning of your command line. For example, you
  190.                       might compile a module like this:
  191.  
  192.                       BCC -WE -DWIN31;STRICT myprog.cpp owlws.lib
  193.                       tclasss.lib
  194.  
  195.                     o If you use any of the IDEs, add "WIN31;STRICT"
  196.                       (without the quotes) to the Options|Compiler|Code
  197.                       Generation|Defines input box. For example, if you
  198.                       already define a macro DEBUG in this input box,
  199.                       adding WIN31;STRICT would look like this:
  200.  
  201.                       DEBUG;WIN31;STRICT
  202.  
  203.                     o You can also add "#define WIN31" and "#define STRICT"
  204.                       in your source code before you include owl.h. For
  205.                       example,
  206.  
  207.                       ...
  208.                       #define WIN31
  209.                       #define STRICT
  210.                       #include <owl.h>
  211.                       ...
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.                                    - 4 -
  227.  
  228.