ArcObjects Library Reference  (Output)    

Paper CoClass

The default printer page settings.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Supported Platforms

Windows, Solaris, Linux

Extended Error Information

Use the ISupportErrorInfo method InterfaceSupportsErrorInfo to determine if the object supports extended error information. If the object supports extended error info, VC++ developers should use the OLE/COM IErrorInfo interface to access the ErrorInfo object. Visual Basic developers should use the global error object Err to retrieve this extended error information.

Interfaces

Interfaces Description
IClone (esriSystem) Provides access to members that control cloning of objects.
IPaper Provides access to members that control the default printer page settings.
IPaper2 Provides access to members that control the default printer page settings.
IPersistStream (esriSystem)
ISupportErrorInfo Indicates whether a specific interface can return Automation error objects.

Remarks

The Paper object is a key object required by the Printer object. The Paper object is responsible for maintaining properties related to the paper and printer used with the Printer object.  In the ArcMap application, the Paper object is accessed throught the Printer Setup section of the Page and Print Setup dialog.

When working with an ArcGIS application like ArcMap, a Paper object is automatically created based on the default printer for the system. To use another printer on the system, you must define a new Paper object and set it to the printer or plotter through the PrinterName property. The Paper object can then be associated with the Printer object through the IPrinter::Paper property.

The Paper object is basically a wrapper for the Microsoft GDI DevMode and DevNames parameters. The Windows GDI documentation on the Microsoft Developer Network (MSDN) library provides further details about these structures. 

The DevNames structure contains strings that identify the driver, device, and output port names for a printer. The DevMode data structure contains information about the device initialization and environment of a printer.

The Attach method is used by a Printer object when the IPrinter::Paper property is set.  ArcObjects developers will typically not need to use this method.

 

QueryPaperSize is a useful method for interrogating the dimensions of the Printer's currently selected Form size.


 

 

Example

esriOutput Paper Example