home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / opendc12.zip / od124os2.exe / od12osp1.exe / src / pagepart / iodpage.txt < prev    next >
Text File  |  1997-04-02  |  4KB  |  96 lines
  1. Description:
  2.  
  3.     The PageLayout part is a sample part which demonstrates pagination
  4.     and printing.  It is available on the Windows 95/NT and OS/2 platforms.
  5.     You can use the PageLayout part to control the alignment of components
  6.     within a document, to control placement of content on multiple pages of a
  7.     document, and to determine the printer setup for a document.  PageLayout
  8.     also provides the pagination framework for documents, such as
  9.     margins, page orientation, page numbering, headers, and footers.
  10.  
  11.     Page Layout must be used as a root component for documents longer
  12.     than one page with consecutive page numbering.  Although Page Layout
  13.     can serve as an embedded part, its usefulness is greatly diminished in
  14.     that capacity; it can only actually control the layout of the printed
  15.     pages when it is the root part of the document.
  16.  
  17. Files:
  18.     iodpage.txt   --  This file.
  19.     iodpage.idl   --  SOM IDL definitions for SOM class PageLayout and
  20.                       meta class M_PageLayout.
  21.     iodpage.cpp   --  PageLayout and M_PageLayout class member functions.
  22.     iodpage.hpp   --  Header file used by iodpage.cpp
  23.     iodpgprn.idl  --  SOM IDL definitions for SOM class PageLayoutPrintExtension.
  24.     iodpgprn.cpp  --  PageLayoutPrintExtension class member functions.
  25.     iodpage.ico   --  Icon file
  26.     iodpage.rc    --  Resource file
  27.     iodpgres.h    --  Header file used by Resource file
  28.     iodpage.def   --  Library definitions
  29.     makefile      --  NMAKE file (To build part run: nmake)
  30.  
  31. How to Build:
  32.  
  33.     To build this part you will need the OpenDoc Release 1.1 toolkit.
  34.  
  35.     From the pagepart source directory run
  36.  
  37.     nmake
  38.  
  39.     To register the part with OpenDoc, run
  40.  
  41.     nmake ForceRegistry
  42.  
  43. Usage:
  44.  
  45.     To run the PageLayout part, issue the command:
  46.  
  47.     docshell -k PageLayout
  48.  
  49.     Other parts can now be embedded in the PageLayout part via
  50.     the Embed Menu.  The Colors menu allows you to change the
  51.     background color of the PageLayout part, the page color, or
  52.     the color of the rulers, margin, and alignment grid.
  53.  
  54.     Additional pages can be added or removed via the Page menu.
  55.     The Page menu also allows you to add a default header and footer
  56.     to each page in the document.
  57.  
  58.     The View menu contains additional options to allow you to display
  59.     rulers along the top and left sides of each page, and to display the
  60.     margins or alignment grid on the page itself.
  61.  
  62.     The Fill Entire Page option on the Edit menu will allow a selected
  63.     part to be expanded to fill a page.  The Snap to Grid option on
  64.     the Edit menu allows selected parts to be moved and resized to fit
  65.     within the nearest corners of the alignment grid.
  66.  
  67.  
  68. Design Notes:
  69.  
  70.     The PageLayout sample currently runs on the Windows 95/NT,
  71.     and OS/2 platforms.  It subclasses from the BaseContainer part
  72.     and from the ODPrintExtension to expand upon the default
  73.     printing behavior provided by the BaseContainer.
  74.     It also uses the ODScrollExtension to allow the user
  75.     to create a multi-page document within a single display frame.
  76.     The Page Layout part demonstrates frame negotiation; it always
  77.     keeps embedded parts within the margins of each page.
  78.  
  79.  
  80. Known Restrictions:
  81.  
  82.     Page Layout is currently unable to print long documents to
  83.     certain printers (the higher the vertical dots-per-inch of the
  84.     printer, the less pages will be able to be printed).  The formula
  85.     for the maximum number of pages that can be printed is:
  86.     
  87.     MaxPages = 32768/((page height in inches+1)*(vertical printer dpi))+1
  88.     
  89.     For example, a 720x360 dpi printer using 11-inch tall paper would
  90.     have a maximum printable page limit of 32768/(12*360)+1, or 8 pages.
  91.  
  92.     To work around this limitation, either decrease the resolution of the
  93.     printout (via Job Properties on the printer), or split up the printout
  94.     into multiple documents.
  95.  
  96.