home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / opendc12.zip / od124os2.exe / od12osp1.exe / src / simple / iodsimpl.txt < prev    next >
Text File  |  1997-04-02  |  3KB  |  55 lines
  1. Description:
  2.  
  3.     The Simple part handler is a sample which demonstrates basic 
  4.     part handler implementation. It subclasses from ODPart and 
  5.     shows the basics of registration, internalization, externalization,
  6.     drawing, and event handling. It also supports the display of
  7.     different view types (i.e. frame, small icon, large icon and thumbnail).
  8.  
  9.     The Simple part does not support containment of other frames
  10.     within it. For an example of containment see the Base Container part
  11.     sample.
  12.  
  13. Files:
  14.  
  15.     iodsimpl.rme   --  This file.
  16.     iodsimpl.idl   --  SOM IDL definitions for SOM class SimplePart and
  17.                        meta class M_SimplePart.
  18.     iodsimpl.cpp   --  Class member functions
  19.     iodsimpl.h     --  Header file
  20.     iodsimpl.msg   --  English message file
  21.     iodsimpl.ico   --  Icon file
  22.     iodsimpd.ico   --  Document Icon File (NT only)
  23.     iodsimpe.ico   --  Editor Icon File (NT only)
  24.     iodsimps.ico   --  Stationery Icon File (NT only)
  25.     iodsimpl.rc    --  Resource file
  26.     iodsimpl.def   --  Library definitions
  27.     makefile       --  NMAKE file (To build part run: nmake)
  28.  
  29. Usage:
  30.  
  31.     The Simple part handler supports the Document, View and Help menues 
  32.     provided by the OpenDoc document shell. Because Simple part does not have 
  33.     modifiable intrinsic content, it disables the Edit menu items. 
  34.  
  35.     The View In Window item of the View menu is enabled only when the part
  36.     is embedded in a document. It is disabled when the part is displayed as a 
  37.     root frame.
  38.  
  39.     Another way of displaying an embedded Simple part in its own window is to
  40.     double click on the part with the left mouse button. This feature is 
  41.     not supported on AIX.
  42.                                   
  43.     In addition to the supported menu items, Simple part owns a "Show As"
  44.     popup menu. This popup menu allows the user to change the view type 
  45.     displayed by the part. It is enabled only when the part is displayed in
  46.     an embedded frame. To display the popup menu press the rightmost mouse 
  47.     button while the part is active. 
  48.  
  49.     When an embedded SimplePart is displayed as an icon or thumbnail, it
  50.     cannot be activated. It can only be selected. Once selected, the only
  51.     way to change the view type of a part displayed as icon/thumbnail is
  52.     through its Properties Notebook. To display the Properties Notebook
  53.     of the part, select the part and choose the Selection Properties item
  54.     of the Edit menu.
  55.