home *** CD-ROM | disk | FTP | other *** search
/ The Developer Connection…ice Driver Kit for OS/2 3 / DEV3-D1.ISO / source / wpshidl / readme
Encoding:
Text File  |  1993-11-18  |  4.9 KB  |  136 lines
  1. ******************************************************************************
  2.  
  3. *                 OS/2* 2.1 Workplace Shell* .IDL files BETA                 *
  4.  
  5. *           (C) Copyright IBM Corp. 1993 All Rights Reserved                 *
  6.  
  7. *                    IBM is a registered trademark of the                    *
  8.  
  9. *                International Business Machines Corporation                 *
  10.  
  11. *  U.S. Government Users Restricted Rights - Use, duplication or disclosure  *
  12.  
  13. *           restricted by GSA ADP Schedule Contract with IBM Corp.           *
  14.  
  15. ******************************************************************************
  16.  
  17.  
  18.   This README document contains information that describes how the
  19.   Beta .IDL files for the Workplace Shell are to be used.
  20.  
  21.   These files are pre-release versions and are provided on an as-is basis
  22.   for evaluation and demonstration.  They are not intended for use with
  23.   production code.
  24.  
  25.   The files included in this beta have been provided for evaluation by
  26.   developers who have the SOMobjects Toolkit* and want to write their
  27.   Workplace Shell subclasses using the Interface Definition Language
  28.   (IDL) described in the SOMobjects Toolkit.
  29.  
  30.   Requirements:
  31.  
  32.         OS/2 V2.1, SOMobjects Developer's Toolkit V2.0, OS/2 V2.1 Toolkit
  33.  
  34.   1.  There are three subdirectories accompanying this README file:
  35.  
  36.       idl     - contains the .idl counterparts for the documented Workplace
  37.                 Shell classes' .sc files provided with the OS/2 2.x Toolkit
  38.  
  39.       h       - contains the .h files emitted from the Workplace Shell's .idl
  40.                 files by the SOM compiler provided with the SOMobjects
  41.                 Toolkit
  42.  
  43.       samples - contains several Workplace Shell subclasses that were written
  44.                 using the IDL syntax described in the SOMobjects Toolkit,
  45.                 or converted from .csc files to .idl files via the
  46.                 CTOI tool provided with the SOMobjects Toolkit.  They are
  47.                 provided merely to illustrate the how to create Workplace
  48.                 Shell IDL subclasses.  NOTE: the makefiles for
  49.                 each of the samples needs to be edited to conform to your
  50.                 environment/path settings.  The process for making and
  51.                 installing each sample is different as well.
  52.  
  53.  
  54.   2.  There is no "installation" procedure accompanying these files.
  55.       Copy the idl files to a directory on your hard drive that is in your
  56.       SMINCLUDE path.  Copy the .h files to a directory on your hard drive
  57.       that is in your INCLUDE path (NOTE: The .h files are NOT replacements
  58.       for those that are currently shipped with the OS/2 2.x Toolkit, so it
  59.       is suggested that you place them in a separate directory that precedes
  60.       \TOOLKT2x\c\os2h in your INCLUDE path).
  61.  
  62.   3.  C++ header files cannot be emitted from these .idl files.
  63.  
  64.   4.  IDL files are provided only for the following Workplace Shell classes
  65.       documented in the OS/2 2.1 Toolkit Presentation Manager* Reference
  66.       Volume II:
  67.  
  68.         WPAbstract
  69.         WPBitmap
  70.         WPClock
  71.         WPColorPalette
  72.         WPCommandFile
  73.         WPCountry
  74.         WPDataFile
  75.         WPDesktop
  76.         WPDisk
  77.         WPDrives
  78.         WPFileSystem
  79.         WPFolder
  80.         WPFontPalette
  81.         WPIcon
  82.         WPKeyboard
  83.         WPMouse
  84.         WPObject
  85.         WPPalette
  86.         WPPointer
  87.         WPPower
  88.         WPProgram
  89.         WPProgramFile
  90.         WPSchemePalette
  91.         WPShadow
  92.         WPSound
  93.         WPSpecialNeeds
  94.         WPStartup
  95.         WPSystem
  96.         WPTemplates
  97.         WPTransient
  98.  
  99.   5.  Note that if you use the SOMobjects Toolkit to develop a Workplace
  100.       Shell subclass from these idl files, as with any other SOM* 2.0 derived
  101.       class, the SOM 2.0 runtime (SOM.DLL) will be a prerequisite for running
  102.       an object of the class.
  103.  
  104.   6.  It is not advised that you employ multiple inheritance with the
  105.       OS/2 2.1 Workplace Shell classes, as they were not tested
  106.       in this fashion, and may result in initialization methods being invoked
  107.       multiple times on the same object.
  108.  
  109.   7.  The Workplace Shell utilizes the SOMSTARS version of the SOMobjects
  110.       Toolkit header files.
  111.  
  112. TRADEMARKS
  113. __________
  114.  
  115.    The following terms, denoted by an asterisk (*)
  116.    in this README, are trademarks or registered
  117.    trademarks of the IBM Corporation in the United
  118.    States or other countries:
  119.  
  120.        OS/2
  121.        Workplace Shell
  122.        SOM
  123.        SOMobjects Toolkit
  124.        Presentation Manager/2
  125.  
  126.    IBM DISCLAIMS ALL WARRANTIES, WHETHER EXPRESSED
  127.    OR IMPLIED, INCLUDING WITHOUT LIMITATION,
  128.    WARRANTIES OF FITNESS AND MERCHANTABILITY WITH
  129.    RESPECT TO THE INFORMATION IN THIS DOCUMENT.
  130.    BY FURNISHING THIS DOCUMENT, IBM GRANTS NO
  131.    LICENSES TO ANY RELATED PATENTS OR COPYRIGHTS.
  132.  
  133.    Copyright IBM Corporation, 1993, all rights
  134.    reserved.
  135.  
  136.