|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object com.esri.arcgis.output.ExportPDF
public class ExportPDF
Class used to export maps to PDF (Portable Document Format) format.
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.
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. |
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 |
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 |
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 |
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. |
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 |
---|
public ExportPDF() throws IOException, UnknownHostException
IOException
- if there are interop problems
UnknownHostException
- if there are interop problemspublic ExportPDF(Object obj) throws IOException
ExportPDF theExportPDF = (ExportPDF) obj;
obj
to ExportPDF
.
obj
- an object returned from ArcGIS Engine or Server
IOException
- if there are interop problemsMethod Detail |
---|
public static String getClsid()
public boolean equals(Object o)
equals
in class Object
public int hashCode()
hashCode
in class Object
public void setPolygonizeMarkers(boolean bPolygonizeMarkers) throws IOException, AutomationException
setPolygonizeMarkers
in interface IExportVectorOptions
bPolygonizeMarkers
- The bPolygonizeMarkers (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public boolean isPolygonizeMarkers() throws IOException, AutomationException
isPolygonizeMarkers
in interface IExportVectorOptions
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setMaxVertexNumber(int lMaxVertices) throws IOException, AutomationException
setMaxVertexNumber
in interface IExportVectorOptions
lMaxVertices
- The lMaxVertices (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public int getMaxVertexNumber() throws IOException, AutomationException
getMaxVertexNumber
in interface IExportVectorOptions
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setExportPictureSymbolOptions(int opt) throws IOException, AutomationException
setExportPictureSymbolOptions
in interface IExportVectorOptionsEx
opt
- A com.esri.arcgis.display.esriPictureSymbolOptions constant (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public int getExportPictureSymbolOptions() throws IOException, AutomationException
getExportPictureSymbolOptions
in interface IExportVectorOptionsEx
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public boolean isCompressed() throws IOException, AutomationException
isCompressed
in interface IExportPDF
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setCompressed(boolean compressed) throws IOException, AutomationException
setCompressed
in interface IExportPDF
compressed
- The compressed (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setImageCompression(int compression) throws IOException, AutomationException
setImageCompression
in interface IExportPDF
compression
- A com.esri.arcgis.output.esriExportImageCompression constant (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public int getImageCompression() throws IOException, AutomationException
getImageCompression
in interface IExportPDF
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setEmbedFonts(boolean embedFonts) throws IOException, AutomationException
setEmbedFonts
in interface IExportPDF
embedFonts
- The embedFonts (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public boolean isEmbedFonts() throws IOException, AutomationException
isEmbedFonts
in interface IExportPDF
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setExportPDFLayersAndFeatureAttributes(int pOption) throws IOException, AutomationException
setExportPDFLayersAndFeatureAttributes
in interface IExportPDF2
pOption
- A com.esri.arcgis.output.esriExportPDFLayerOptions constant (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public int getExportPDFLayersAndFeatureAttributes() throws IOException, AutomationException
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.
getExportPDFLayersAndFeatureAttributes
in interface IExportPDF2
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setExportMeasureInfo(boolean pbMeasureInformation) throws IOException, AutomationException
setExportMeasureInfo
in interface IExportPDF2
pbMeasureInformation
- The pbMeasureInformation (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public boolean isExportMeasureInfo() throws IOException, AutomationException
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"
isExportMeasureInfo
in interface IExportPDF2
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setJPEGCompressionQuality(short pImageQuality) throws IOException, AutomationException
setJPEGCompressionQuality
in interface IExportPDF3
pImageQuality
- The pImageQuality (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public short getJPEGCompressionQuality() throws IOException, AutomationException
getJPEGCompressionQuality
in interface IExportPDF3
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setMultipleFileOutput(int pOption) throws IOException, AutomationException
setMultipleFileOutput
in interface IExportPagesMultipleFile
pOption
- A com.esri.arcgis.output.esriExportMultipleFiles constant (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public int getMultipleFileOutput() throws IOException, AutomationException
getMultipleFileOutput
in interface IExportPagesMultipleFile
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public String getName() throws IOException, AutomationException
getName
in interface IExport
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public String getFilter() throws IOException, AutomationException
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.
getFilter
in interface IExport
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public int getPriority() throws IOException, AutomationException
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.
getPriority
in interface IExport
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setStepProgressorByRef(IStepProgressor rhs1) throws IOException, AutomationException
setStepProgressorByRef
in interface IExport
rhs1
- A reference to a com.esri.arcgis.system.IStepProgressor (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setTrackCancelByRef(ITrackCancel rhs1) throws IOException, AutomationException
setTrackCancelByRef
in interface IExport
rhs1
- A reference to a com.esri.arcgis.system.ITrackCancel (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setPixelBounds(IEnvelope pixelBounds) throws IOException, AutomationException
setPixelBounds
in interface IExport
pixelBounds
- A reference to a com.esri.arcgis.geometry.IEnvelope (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public IEnvelope getPixelBounds() throws IOException, AutomationException
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.
getPixelBounds
in interface IExport
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setExportFileName(String fileName) throws IOException, AutomationException
setExportFileName
in interface IExport
fileName
- The fileName (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public String getExportFileName() throws IOException, AutomationException
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.
getExportFileName
in interface IExport
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setResolution(double res) throws IOException, AutomationException
setResolution
in interface IExport
res
- The res (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public double getResolution() throws IOException, AutomationException
getResolution
in interface IExport
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public int startExporting() throws IOException, AutomationException
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.
startExporting
in interface IExport
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void finishExporting() throws IOException, AutomationException
finishExporting
in interface IExport
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void cleanup() throws IOException, AutomationException
cleanup
in interface IExport
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void restoreForCurrentUser(String bstrRegPath) throws IOException, AutomationException
restoreForCurrentUser
in interface ISettingsInRegistry
bstrRegPath
- The bstrRegPath (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void storeForCurrentUser(String bstrRegPath) throws IOException, AutomationException
storeForCurrentUser
in interface ISettingsInRegistry
bstrRegPath
- The bstrRegPath (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void restoreDefault() throws IOException, AutomationException
restoreDefault
in interface ISettingsInRegistry
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setColorspace(int pcolorspace) throws IOException, AutomationException
setColorspace
in interface IExportColorspaceSettings
pcolorspace
- A com.esri.arcgis.output.esriExportColorspace constant (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public int getColorspace() throws IOException, AutomationException
getColorspace
in interface IExportColorspaceSettings
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void interfaceSupportsErrorInfo(GUID riid) throws IOException, AutomationException
Indicates whether the interface supports IErrorInfo.
interfaceSupportsErrorInfo
in interface ISupportErrorInfo
riid
- A Structure: com.esri.arcgis.support.ms.stdole.GUID (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public int getResampleRatio() throws IOException, AutomationException
getResampleRatio
in interface IOutputRasterSettings
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setResampleRatio(int pRatio) throws IOException, AutomationException
setResampleRatio
in interface IOutputRasterSettings
pRatio
- The pRatio (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |