com.esri.arcgis.output
Class ExportPDF

java.lang.Object
  extended by com.esri.arcgis.output.ExportPDF
All Implemented Interfaces:
IOutputRasterSettings, com.esri.arcgis.interop.RemoteObjRef, IExport, IExportColorspaceSettings, IExportPagesMultipleFile, IExportPDF, IExportPDF2, IExportPDF3, IExportPDFPasswordSecurity, IExportVector, IExportVectorOptions, IExportVectorOptionsEx, ISettingsInRegistry, ISupportErrorInfo, Serializable

public class ExportPDF
extends Object
implements com.esri.arcgis.interop.RemoteObjRef, IExportVector, IExportVectorOptions, IExportVectorOptionsEx, IExportPDF, IExportPDF2, IExportPDF3, IExportPagesMultipleFile, IExportPDFPasswordSecurity, IExport, ISettingsInRegistry, IExportColorspaceSettings, ISupportErrorInfo, IOutputRasterSettings

Class used to export maps to PDF (Portable Document Format) format.

Remarks

Use the ExportPDF CoClass to export your map to PDF (Portable Document Format). PDF files are designed to be consistently viewable and printable across different platforms. They are commonly used for distributing documents on the Web, and are becoming a standard interchange format for high-end printing. ArcMap PDFs are editable in many graphics applications.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

See Also:
Serialized Form

Constructor Summary
ExportPDF()
          Constructs a ExportPDF using ArcGIS Engine.
ExportPDF(Object obj)
          Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
ExportPDF theExportPDF = (ExportPDF) obj;
 
Method Summary
 void cleanup()
          Cleanup should clean all temporary files, free used memory, etc...
 boolean equals(Object o)
          Compare this object with another
 void finishExporting()
          Shuts down the Exporter.
static String getClsid()
          getClsid.
 int getColorspace()
          Colorspace option.
 String getExportFileName()
          The Export File Name.
 int getExportPDFLayersAndFeatureAttributes()
          PDF Layers and Feature Attributes option.
 int getExportPictureSymbolOptions()
          Options describing what to do with Picture Symbol on export.
 String getFilter()
          Filter String used in the CFileDialog class.
 int getImageCompression()
          The PDF Image Compression.
 short getJPEGCompressionQuality()
          Specifies the raster image quality setting, when JPEG compression is used.
 String getMasterPassword()
          Master password, allows to restrict editing security and permission settings of PDF document.
 int getMaxVertexNumber()
          Maximum number of vertices in feature.
 int getMultipleFileOutput()
          Specify how multipage pdf to be exported.
 String getName()
          The Name of the Exporter.
 IEnvelope getPixelBounds()
          The Export Bounds in Pixels (The Pixel Bounds of the Export surface).
 int getPriority()
          Exporter's priority - the order of appearance in the user interface.
 int getResampleRatio()
          This coefficient states the scale level for the raster when it goes to output.
 double getResolution()
          The Export Resolution.
 int getSecurityEncryptionMethod()
          PDF security encryption methods.
 int getSecurityEncryptionOption()
          PDF security encryption options.
 int getSecurityPermissions()
          PDF security permissions.
 String getUserPassword()
          User password, allows to open the PDF document.
 int hashCode()
          the hashcode for this object
 void interfaceSupportsErrorInfo(GUID riid)
          interfaceSupportsErrorInfo
 boolean isCompressed()
          Indicates if the PDF should be compressed.
 boolean isEmbedFonts()
          The Embed Fonts option.
 boolean isExportMeasureInfo()
          Indicates whether geographic coordinate and measurement information is exported.
 boolean isPolygonizeMarkers()
          Polygonize (represent as vectors instead of fonts) marker symbols option.
 void restoreDefault()
          Restore the default object settings.
 void restoreForCurrentUser(String bstrRegPath)
          Restore object settings.
 void setColorspace(int pcolorspace)
          Colorspace option.
 void setCompressed(boolean compressed)
          Indicates if the PDF should be compressed.
 void setEmbedFonts(boolean embedFonts)
          The Embed Fonts option.
 void setExportFileName(String fileName)
          The Export File Name.
 void setExportMeasureInfo(boolean pbMeasureInformation)
          Indicates whether geographic coordinate and measurement information is exported.
 void setExportPDFLayersAndFeatureAttributes(int pOption)
          PDF Layers and Feature Attributes option.
 void setExportPictureSymbolOptions(int opt)
          Options describing what to do with Picture Symbol on export.
 void setImageCompression(int compression)
          The PDF Image Compression.
 void setJPEGCompressionQuality(short pImageQuality)
          Specifies the raster image quality setting, when JPEG compression is used.
 void setMasterPassword(String pPasswd)
          Master password, allows to restrict editing security and permission settings of PDF document.
 void setMaxVertexNumber(int lMaxVertices)
          Maximum number of vertices in feature.
 void setMultipleFileOutput(int pOption)
          Specify how multipage pdf to be exported.
 void setPixelBounds(IEnvelope pixelBounds)
          The Export Bounds in Pixels (The Pixel Bounds of the Export surface).
 void setPolygonizeMarkers(boolean bPolygonizeMarkers)
          Polygonize (represent as vectors instead of fonts) marker symbols option.
 void setResampleRatio(int pRatio)
          This coefficient states the scale level for the raster when it goes to output.
 void setResolution(double res)
          The Export Resolution.
 void setSecurityEncryptionMethod(int pEncryptionMethod)
          PDF security encryption methods.
 void setSecurityEncryptionOption(int pEncryptionOption)
          PDF security encryption options.
 void setSecurityPermissions(int pPermission)
          PDF security permissions.
 void setStepProgressorByRef(IStepProgressor rhs1)
          Export will update a Progress Bar if StepProgressor is not NULL.
 void setTrackCancelByRef(ITrackCancel rhs1)
          Export will react on Cancel if TrackCancel is not NULL.
 void setUserPassword(String pPasswd)
          User password, allows to open the PDF document.
 int startExporting()
          Initializes the Exporter.
 void storeForCurrentUser(String bstrRegPath)
          Store object settings.
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
 
Methods inherited from interface com.esri.arcgis.interop.RemoteObjRef
getJintegraDispatch, release
 

Constructor Detail

ExportPDF

public ExportPDF()
          throws IOException,
                 UnknownHostException
Constructs a ExportPDF using ArcGIS Engine.

Throws:
IOException - if there are interop problems
UnknownHostException - if there are interop problems

ExportPDF

public ExportPDF(Object obj)
          throws IOException
Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
ExportPDF theExportPDF = (ExportPDF) obj;

Construct a ExportPDF using a reference to such an object returned from ArcGIS Engine or Server. This is semantically equivalent to casting obj to ExportPDF.

Parameters:
obj - an object returned from ArcGIS Engine or Server
Throws:
IOException - if there are interop problems
Method Detail

getClsid

public static String getClsid()
getClsid.


equals

public boolean equals(Object o)
Compare this object with another

Overrides:
equals in class Object

hashCode

public int hashCode()
the hashcode for this object

Overrides:
hashCode in class Object

setPolygonizeMarkers

public void setPolygonizeMarkers(boolean bPolygonizeMarkers)
                          throws IOException,
                                 AutomationException
Polygonize (represent as vectors instead of fonts) marker symbols option.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setPolygonizeMarkers in interface IExportVectorOptions
Parameters:
bPolygonizeMarkers - The bPolygonizeMarkers (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isPolygonizeMarkers

public boolean isPolygonizeMarkers()
                            throws IOException,
                                   AutomationException
Polygonize (represent as vectors instead of fonts) marker symbols option.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
isPolygonizeMarkers in interface IExportVectorOptions
Returns:
The bPolygonizeMarkers
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setMaxVertexNumber

public void setMaxVertexNumber(int lMaxVertices)
                        throws IOException,
                               AutomationException
Maximum number of vertices in feature.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setMaxVertexNumber in interface IExportVectorOptions
Parameters:
lMaxVertices - The lMaxVertices (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getMaxVertexNumber

public int getMaxVertexNumber()
                       throws IOException,
                              AutomationException
Maximum number of vertices in feature.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getMaxVertexNumber in interface IExportVectorOptions
Returns:
The lMaxVertices
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setExportPictureSymbolOptions

public void setExportPictureSymbolOptions(int opt)
                                   throws IOException,
                                          AutomationException
Options describing what to do with Picture Symbol on export.

Product Availability

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

Specified by:
setExportPictureSymbolOptions in interface IExportVectorOptionsEx
Parameters:
opt - A com.esri.arcgis.display.esriPictureSymbolOptions constant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getExportPictureSymbolOptions

public int getExportPictureSymbolOptions()
                                  throws IOException,
                                         AutomationException
Options describing what to do with Picture Symbol on export.

Product Availability

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

Specified by:
getExportPictureSymbolOptions in interface IExportVectorOptionsEx
Returns:
A com.esri.arcgis.display.esriPictureSymbolOptions constant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isCompressed

public boolean isCompressed()
                     throws IOException,
                            AutomationException
Indicates if the PDF should be compressed.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
isCompressed in interface IExportPDF
Returns:
The compressed
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setCompressed

public void setCompressed(boolean compressed)
                   throws IOException,
                          AutomationException
Indicates if the PDF should be compressed.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setCompressed in interface IExportPDF
Parameters:
compressed - The compressed (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setImageCompression

public void setImageCompression(int compression)
                         throws IOException,
                                AutomationException
The PDF Image Compression.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setImageCompression in interface IExportPDF
Parameters:
compression - A com.esri.arcgis.output.esriExportImageCompression constant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getImageCompression

public int getImageCompression()
                        throws IOException,
                               AutomationException
The PDF Image Compression.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getImageCompression in interface IExportPDF
Returns:
A com.esri.arcgis.output.esriExportImageCompression constant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setEmbedFonts

public void setEmbedFonts(boolean embedFonts)
                   throws IOException,
                          AutomationException
The Embed Fonts option.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setEmbedFonts in interface IExportPDF
Parameters:
embedFonts - The embedFonts (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isEmbedFonts

public boolean isEmbedFonts()
                     throws IOException,
                            AutomationException
The Embed Fonts option.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
isEmbedFonts in interface IExportPDF
Returns:
The embedFonts
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setExportPDFLayersAndFeatureAttributes

public void setExportPDFLayersAndFeatureAttributes(int pOption)
                                            throws IOException,
                                                   AutomationException
PDF Layers and Feature Attributes option.

Product Availability

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

Specified by:
setExportPDFLayersAndFeatureAttributes in interface IExportPDF2
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

public 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.

Specified by:
getExportPDFLayersAndFeatureAttributes in interface IExportPDF2
Returns:
A com.esri.arcgis.output.esriExportPDFLayerOptions constant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setExportMeasureInfo

public 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.

Specified by:
setExportMeasureInfo in interface IExportPDF2
Parameters:
pbMeasureInformation - The pbMeasureInformation (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isExportMeasureInfo

public 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.

Specified by:
isExportMeasureInfo in interface IExportPDF2
Returns:
The pbMeasureInformation
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setJPEGCompressionQuality

public void setJPEGCompressionQuality(short pImageQuality)
                               throws IOException,
                                      AutomationException
Specifies the raster image quality setting, when JPEG compression is used.

Product Availability

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

Specified by:
setJPEGCompressionQuality in interface IExportPDF3
Parameters:
pImageQuality - The pImageQuality (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getJPEGCompressionQuality

public short getJPEGCompressionQuality()
                                throws IOException,
                                       AutomationException
Specifies the raster image quality setting, when JPEG compression is used.

Product Availability

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

Specified by:
getJPEGCompressionQuality in interface IExportPDF3
Returns:
The pImageQuality
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setMultipleFileOutput

public void setMultipleFileOutput(int pOption)
                           throws IOException,
                                  AutomationException
Specify how multipage pdf to be exported.

Product Availability

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

Specified by:
setMultipleFileOutput in interface IExportPagesMultipleFile
Parameters:
pOption - A com.esri.arcgis.output.esriExportMultipleFiles constant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getMultipleFileOutput

public int getMultipleFileOutput()
                          throws IOException,
                                 AutomationException
Specify how multipage pdf to be exported.

Product Availability

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

Specified by:
getMultipleFileOutput in interface IExportPagesMultipleFile
Returns:
A com.esri.arcgis.output.esriExportMultipleFiles constant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setUserPassword

public void setUserPassword(String pPasswd)
                     throws IOException,
                            AutomationException
User password, allows to open the PDF document.

Product Availability

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

Specified by:
setUserPassword in interface IExportPDFPasswordSecurity
Parameters:
pPasswd - The pPasswd (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getUserPassword

public String getUserPassword()
                       throws IOException,
                              AutomationException
User password, allows to open the PDF document.

Product Availability

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

Specified by:
getUserPassword in interface IExportPDFPasswordSecurity
Returns:
The pPasswd
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setMasterPassword

public void setMasterPassword(String pPasswd)
                       throws IOException,
                              AutomationException
Master password, allows to restrict editing security and permission settings of PDF document.

Product Availability

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

Specified by:
setMasterPassword in interface IExportPDFPasswordSecurity
Parameters:
pPasswd - The pPasswd (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getMasterPassword

public String getMasterPassword()
                         throws IOException,
                                AutomationException
Master password, allows to restrict editing security and permission settings of PDF document.

Product Availability

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

Specified by:
getMasterPassword in interface IExportPDFPasswordSecurity
Returns:
The pPasswd
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setSecurityPermissions

public void setSecurityPermissions(int pPermission)
                            throws IOException,
                                   AutomationException
PDF security permissions.

Product Availability

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

Specified by:
setSecurityPermissions in interface IExportPDFPasswordSecurity
Parameters:
pPermission - The pPermission (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getSecurityPermissions

public int getSecurityPermissions()
                           throws IOException,
                                  AutomationException
PDF security permissions.

Product Availability

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

Specified by:
getSecurityPermissions in interface IExportPDFPasswordSecurity
Returns:
The pPermission
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setSecurityEncryptionOption

public void setSecurityEncryptionOption(int pEncryptionOption)
                                 throws IOException,
                                        AutomationException
PDF security encryption options.

Product Availability

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

Specified by:
setSecurityEncryptionOption in interface IExportPDFPasswordSecurity
Parameters:
pEncryptionOption - A com.esri.arcgis.output.esriPDFExtensionSecurityEncryptionOption constant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getSecurityEncryptionOption

public int getSecurityEncryptionOption()
                                throws IOException,
                                       AutomationException
PDF security encryption options.

Product Availability

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

Specified by:
getSecurityEncryptionOption in interface IExportPDFPasswordSecurity
Returns:
A com.esri.arcgis.output.esriPDFExtensionSecurityEncryptionOption constant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setSecurityEncryptionMethod

public void setSecurityEncryptionMethod(int pEncryptionMethod)
                                 throws IOException,
                                        AutomationException
PDF security encryption methods.

Product Availability

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

Specified by:
setSecurityEncryptionMethod in interface IExportPDFPasswordSecurity
Parameters:
pEncryptionMethod - A com.esri.arcgis.output.esriPDFExtensionSecurityEncryptionMethod constant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getSecurityEncryptionMethod

public int getSecurityEncryptionMethod()
                                throws IOException,
                                       AutomationException
PDF security encryption methods.

Product Availability

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

Specified by:
getSecurityEncryptionMethod in interface IExportPDFPasswordSecurity
Returns:
A com.esri.arcgis.output.esriPDFExtensionSecurityEncryptionMethod constant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getName

public String getName()
               throws IOException,
                      AutomationException
The Name of the Exporter.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getName in interface IExport
Returns:
The name
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getFilter

public String getFilter()
                 throws IOException,
                        AutomationException
Filter String used in the CFileDialog class.

Remarks

This method is primarily used for defining the extension of the export file name within the Export Map dialog. The string contained in this value is a null-terminated pattern string that follows the standard for a Windows Open and Save As dialog filter. The value of this property can change according to the state of the export object. An ExportSVG object, for example, returns "SVG (*.svg)|*.svg" when its compression property is False, and "Compressed SVG (*.svgz)|*.svgz" when the compression property is True. This makes the Filter ideal for automatically assigning the appropriate file name extension for an export file.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getFilter in interface IExport
Returns:
The filter
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getPriority

public int getPriority()
                throws IOException,
                       AutomationException
Exporter's priority - the order of appearance in the user interface.

Remarks

Primarily used by export dialogs for ordering the appearance of export formats in the 'Save As...' pulldown list. By ordering through this property, the export dialog can group similar formats together. For example, all raster export formats are grouped together in the 'Save As...' list.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getPriority in interface IExport
Returns:
The pPriority
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setStepProgressorByRef

public void setStepProgressorByRef(IStepProgressor rhs1)
                            throws IOException,
                                   AutomationException
Export will update a Progress Bar if StepProgressor is not NULL.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setStepProgressorByRef in interface IExport
Parameters:
rhs1 - A reference to a com.esri.arcgis.system.IStepProgressor (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setTrackCancelByRef

public void setTrackCancelByRef(ITrackCancel rhs1)
                         throws IOException,
                                AutomationException
Export will react on Cancel if TrackCancel is not NULL.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setTrackCancelByRef in interface IExport
Parameters:
rhs1 - A reference to a com.esri.arcgis.system.ITrackCancel (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setPixelBounds

public void setPixelBounds(IEnvelope pixelBounds)
                    throws IOException,
                           AutomationException
The Export Bounds in Pixels (The Pixel Bounds of the Export surface).

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setPixelBounds in interface IExport
Parameters:
pixelBounds - A reference to a com.esri.arcgis.geometry.IEnvelope (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getPixelBounds

public IEnvelope getPixelBounds()
                         throws IOException,
                                AutomationException
The Export Bounds in Pixels (The Pixel Bounds of the Export surface).

Remarks

The PixelBounds represents the height and width of the export image in device units (usually pixels for a export file). To set up values to use in this property, get the height and width of the image draw to screen. Then multiply each dimension by the ratio of the output resolution to screen resolution.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getPixelBounds in interface IExport
Returns:
A reference to a com.esri.arcgis.geometry.IEnvelope
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setExportFileName

public void setExportFileName(String fileName)
                       throws IOException,
                              AutomationException
The Export File Name.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setExportFileName in interface IExport
Parameters:
fileName - The fileName (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getExportFileName

public String getExportFileName()
                         throws IOException,
                                AutomationException
The Export File Name.

Remarks

You must assign a value to the ExportFileName property before calling the IExport::StartExporting() method. There are two exceptions to this. If IExport is controlling a ExportBMP or ExportEMF object, you can assign an empty string to the ExportFileName property without an error being raised on StartExporting(). This is to allow cases where the application will use the export object as a intermediate container for a drawing, and won't be written to an export file.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getExportFileName in interface IExport
Returns:
The fileName
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setResolution

public void setResolution(double res)
                   throws IOException,
                          AutomationException
The Export Resolution.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setResolution in interface IExport
Parameters:
res - The res (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getResolution

public double getResolution()
                     throws IOException,
                            AutomationException
The Export Resolution.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getResolution in interface IExport
Returns:
The res
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

startExporting

public int startExporting()
                   throws IOException,
                          AutomationException
Initializes the Exporter.

Remarks

The StartExporting method causes the export object to allocate memory for the export based on resolution, bit depth, and pixel bounds. The method returns a long that represents the hDC (Windows GDI Device Context handle) of the export object. After this method is called, the export object is ready to receive GDI draw instructions directed to its hDC.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
startExporting in interface IExport
Returns:
The hDC (A COM typedef)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

finishExporting

public void finishExporting()
                     throws IOException,
                            AutomationException
Shuts down the Exporter.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
finishExporting in interface IExport
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

cleanup

public void cleanup()
             throws IOException,
                    AutomationException
Cleanup should clean all temporary files, free used memory, etc...

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
cleanup in interface IExport
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

restoreForCurrentUser

public void restoreForCurrentUser(String bstrRegPath)
                           throws IOException,
                                  AutomationException
Restore object settings.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
restoreForCurrentUser in interface ISettingsInRegistry
Parameters:
bstrRegPath - The bstrRegPath (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

storeForCurrentUser

public void storeForCurrentUser(String bstrRegPath)
                         throws IOException,
                                AutomationException
Store object settings.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
storeForCurrentUser in interface ISettingsInRegistry
Parameters:
bstrRegPath - The bstrRegPath (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

restoreDefault

public void restoreDefault()
                    throws IOException,
                           AutomationException
Restore the default object settings.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
restoreDefault in interface ISettingsInRegistry
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setColorspace

public void setColorspace(int pcolorspace)
                   throws IOException,
                          AutomationException
Colorspace option.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setColorspace in interface IExportColorspaceSettings
Parameters:
pcolorspace - A com.esri.arcgis.output.esriExportColorspace constant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getColorspace

public int getColorspace()
                  throws IOException,
                         AutomationException
Colorspace option.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getColorspace in interface IExportColorspaceSettings
Returns:
A com.esri.arcgis.output.esriExportColorspace constant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

interfaceSupportsErrorInfo

public void interfaceSupportsErrorInfo(GUID riid)
                                throws IOException,
                                       AutomationException
interfaceSupportsErrorInfo

Description

Indicates whether the interface supports IErrorInfo.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
interfaceSupportsErrorInfo in interface ISupportErrorInfo
Parameters:
riid - A Structure: com.esri.arcgis.support.ms.stdole.GUID (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getResampleRatio

public int getResampleRatio()
                     throws IOException,
                            AutomationException
This coefficient states the scale level for the raster when it goes to output. 1 means 1:1; 2 means 1:2, i.e. 2 times less than the output quality.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
getResampleRatio in interface IOutputRasterSettings
Returns:
The pRatio
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setResampleRatio

public void setResampleRatio(int pRatio)
                      throws IOException,
                             AutomationException
This coefficient states the scale level for the raster when it goes to output. 1 means 1:1; 2 means 1:2, i.e. 2 times less than the output quality.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Specified by:
setResampleRatio in interface IOutputRasterSettings
Parameters:
pRatio - The pRatio (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.