home *** CD-ROM | disk | FTP | other *** search
/ Power GUI Programming with VisualAge C++ / powergui.iso / trialva / ibmcppw / samples / ioc / clipbrd / readme.txt < prev   
Encoding:
Text File  |  1996-02-22  |  3.2 KB  |  88 lines
  1. **********************************************************************
  2. * DISCLAIMER OF WARRANTIES:                                          *
  3. *                                                                    *
  4. * The following enclosed code is sample code created by IBM          *
  5. * Corporation.  This sample code is not part of any standard IBM     *
  6. * product and is provided to you solely for the purpose of assisting *
  7. * you in the development of your applications.  The code is provided *
  8. * "AS IS", without warranty of any kind.  IBM shall not be liable    *
  9. * for any damages arising out of your use of the sample code, even   *
  10. * if they have been advised of the possibility of such damages       *
  11. *                                                                    *
  12. **********************************************************************
  13.  
  14. Clipboard Sample
  15.  
  16.   DESCRIPTION:
  17.     The Clipboard Sample illustrates a
  18.     container with clipboard support.
  19.     A popup menu appears over an object with
  20.     cut, copy, and paste actions.
  21.     Classes used include
  22.     IContainerControl, IContainerObject,
  23.     and IClipboard.
  24.  
  25.   CONCEPT/FEATURE:
  26.     -  Create and display a container
  27.     -  Clipboard actions for cut, copy, and paste
  28.  
  29.   HOW TO BUILD THE PROJECT FROM THE COMMAND LINE:
  30.     From within the directory containing the sample, simply type:
  31.          NMAKE
  32.  
  33.   HOW TO BUILD THE PROJECT FROM WITHIN THE WORKFRAME ENVIRONMENT:
  34.     Refer to the standard Workframe BUILD instructions
  35.  
  36.   HOW TO RUN THE PROJECT FROM THE COMMAND LINE:
  37.     From within the directory containing the sample, simply type
  38.     the name of the executable:
  39.          CLIPBRD
  40.  
  41.   HOW TO RUN THE PROJECT FROM WITHIN THE WORKFRAME ENVIRONMENT:
  42.     Refer to the standard Workframe RUN instructions
  43.  
  44.   SPECIAL NOTES:
  45.     If the sample fails to execute or
  46.     abnormally ends, you can get
  47.     more information about the failure
  48.     by turning on the ICLUI trace.
  49.     This is done by setting the
  50.     environment variable ICLUI_TRACE
  51.     as follows:
  52.  
  53.         set ICLUI_TRACE=ON
  54.         set ICLUI_TRACETO=STDERR
  55.  
  56.     ICLUI_TRACETO controls where
  57.     the trace information is reported.
  58.     With tracing turned on, ICLUI
  59.     exception text will be written to a
  60.     standard error file. For example:
  61.  
  62.         sample >sample.out 2>&1
  63.  
  64.     The exception data is now in the file
  65.     'sample.out'.
  66.  
  67.   ADDITIONAL HARDWARE/SOFTWARE REQUIREMENTS:
  68.     The paste option will not work within the same application process
  69.     on Windows NT and Windows 3.x.
  70.     This is a known problem and will be addressed in follow-on product
  71.     updates.  A short term solution is lock the text data before the
  72.     paste such as:
  73.  
  74.       void* textData = data(aFormat);
  75.       textData = ::GlobalLock(textData);
  76.       IString str((char*)textData);
  77.       ::GlobalUnlock(textData);
  78.  
  79.   VISUALAGE FOR C++ SAMPLES INFORMATION:
  80.     A complete listing of samples shipped with the VisualAge for C++
  81.     product can be found in the online GUIDE TO SAMPLES.  To access
  82.     this notebook, simply:
  83.  
  84.     -  Open the VISUALAGE FOR C++ program group in the Program
  85.        Manager window, then
  86.     -  Open the GUIDE TO SAMPLES notebook in the program group.
  87.  
  88.