com.esri.arcgis.output
Interface IExportPDF2

All Superinterfaces:

Serializable

All Known Implementing Classes:

ExportPDF

public interface IExportPDF2
extends Serializable

Provides extended access to members that control the PDF (Portable Document Format) Export.

Description

This interface is new at ArcGIS 9.3.

Product Availability

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

Method Summary

int	getExportPDFLayersAndFeatureAttributes() PDF Layers and Feature Attributes option.
boolean	isExportMeasureInfo() Indicates whether geographic coordinate and measurement information is exported.
void	setExportMeasureInfo(boolean pbMeasureInformation) Indicates whether geographic coordinate and measurement information is exported.
void	setExportPDFLayersAndFeatureAttributes(int pOption) PDF Layers and Feature Attributes option.

Method Detail

setExportPDFLayersAndFeatureAttributes

void setExportPDFLayersAndFeatureAttributes(int pOption)
                                            throws IOException,
                                                   AutomationException

PDF Layers and Feature Attributes option.

Product Availability

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

Parameters:

pOption - A com.esri.arcgis.output.esriExportPDFLayerOptions constant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getExportPDFLayersAndFeatureAttributes

int getExportPDFLayersAndFeatureAttributes()
                                           throws IOException,
                                                  AutomationException

PDF Layers and Feature Attributes option.

Remarks

PDF files can include advanced functionality in addition to their usage as a graphic interchange format. PDFs can contain layers corresponding to the layers in the map, so that users can enable and disable the visibility of layers and layout elements when viewing the PDF. Additionally, PDF files can contain attribute information that users can query and identify using the Object Data tool in Adobe Reader and Adobe Acrobat.

The value of the ExportPDFLayersAndFeatureAttributes property determines whether PDF layers and PDF object data (attributes) will be present in the exported PDF file.

esriExportPDFLayerOptionsNone - the exported file will not contain PDF layers or PDF object data
esriExportPDFLayerOptionsLayersOnly - the exported file will contain PDF layers but no PDF object data
esriExportPDFLayerOptionsLayersAndFeatureAttributes - the exported file will contain PDF layers and PDF object data

Exporting feature attributes to PDF object data can lead to performance problems when viewing the file in supported PDF readers. If possible, limit exported fields to one layer per map. To suppress field export, turn off field visibility via the IFieldInfo2 interface.

Product Availability

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

Returns:

A com.esri.arcgis.output.esriExportPDFLayerOptions constant

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setExportMeasureInfo

void setExportMeasureInfo(boolean pbMeasureInformation)
                          throws IOException,
                                 AutomationException

Indicates whether geographic coordinate and measurement information is exported.

Product Availability

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

Parameters:

pbMeasureInformation - The pbMeasureInformation (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isExportMeasureInfo

boolean isExportMeasureInfo()
                            throws IOException,
                                   AutomationException

Indicates whether geographic coordinate and measurement information is exported.

Remarks

Recent versions of Adobe Acrobat and Adobe Reader allow for encoding of map coordinate system and georeference information inside the PDF file. Exporting a map with the ExportMeasureInfo property set to True will record map georeference information inside the PDF. When the georeferenced PDF is opened in a compatible viewer, such as Adobe Reader 9, the user can access geospatial functions such as coordinate readout and find XY.

With the 9.3 PDF patch installed, the default value of this property is True. The patch is available for public download: "ArcGIS (Desktop, Engine, Server) 9.3 Map Export Patch to support Adobe Acrobat 9 PDF"

Product Availability

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

Returns:

The pbMeasureInformation

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.