Pitney Bowes MapXtreme - Manual (Page 520)

Appendix E: Printing From MapXtreme Applications
Overview
MapXtreme v7.1 527 Developer Guide
Overview
Printing from MapXtreme-developed applications can usually be straight forward. However as the
variety of printing devices continue to expand, device-specific problems do occur. We provide a
variety of features to you, the developer, to customize your user’s printing experience. These options
are designed to optimize printing depending on the map being printed and the device being used.
These different settings are designed to meet the needs and nuances of a variety of printers and
plotters.
MapXtreme supports:
• Printing maps – Use the MapPrintDocument class.
• Printing legends – Use the LegendPrintDocument class.
• Printing either directly to a device or by using an Enhanced Metafile (EMF).
• Printing maps in different sizes
• Printing maps that have translucent style colors and layers
See GDI+ Translucency and Anti-Aliasing for information.
• Printing translucent raster images
EnableTranslucency must be enabled to print translucent raster images.
MapXtreme does not support:
• The use of a printing options dialog box.
• Printing of layouts.
Layouts are important for the printing of legends in a map. See Printing a Legend in Your
Map for an example of how to get around this limitation.
• Printing multiple page maps.
If a map does span across multiple pages, only the first page is printed.
• Printing to a file programmatically.
You would need to use the Microsoft.NET 2.0 Framework System.Printing.PrinterSettings
class to implement this functionality.
The classes that handle printing in MapXtreme applications are derived from the Microsoft.NET 2.0
Framework System.Drawing.PrintDocument class and inherit that functionality. Device output
control is managed by the Microsoft.NET 2.0 Framework System.Printing.PrinterSettings and
System.Printing.PageSettings classes. The MapInfo.Printing.MapPrintDocument class is specifically
for printing maps, while the MapInfo.Printing.LegendPrintDocument is used specifically for printing
legends.
Understanding the Print Options in MapXtreme
When printing a map or a legend from a MapXtreme application you can provide the following
options for printing to your user. In order to give your users control over these settings, you need to
build this functionality into the printing dialog boxes of your application. If you do not specifically
allow them to change these options the default settings are used. You can also adjust these settings
programmatically.