com.esri.arcgis.carto
Class BasicOverposter

java.lang.Object
  extended by com.esri.arcgis.carto.BasicOverposter
All Implemented Interfaces:
IOverposter, IOverposter2, IOverposter3, IOverposter4, IConnectionPointContainer, com.esri.arcgis.interop.RemoteObjRef, IPersist, IPersistStream, java.io.Externalizable, java.io.Serializable

public class BasicOverposter
extends java.lang.Object
implements com.esri.arcgis.interop.RemoteObjRef, IOverposter, IOverposter2, IOverposter3, IOverposter4, IConnectionPointContainer, IPersist, IPersistStream, java.io.Externalizable

COM Class 'BasicOverposter'. Generated 3/19/2015 1:20:41 PM from 'C:\ArcGIS\COM\esriCarto.olb'

Description 'An engine that places labels for features using conflict detection.' Generator Options: PromptForTypeLibraries = False ClashPrefix = esri_ LowerCaseMemberNames = True IDispatchOnly = False RetryOnReject = False AwtForOcxs = True ArraysAsObjects = False DontRenameSameMethods = False ImplementConflictingInterfaces = True ReuseMethods = True RenameConflictingInterfaceMethods = True GenBeanInfo = True GenerateJavadoc =

See Also:
Serialized Form

Field Summary
static long serialVersionUID
           
 
Fields inherited from interface com.esri.arcgis.carto.IOverposter
IID, IID3141f2f5_38e2_11d1_8809_080009ec732a, xxDummy
 
Fields inherited from interface com.esri.arcgis.carto.IOverposter2
IID, IIDffec8117_ec4f_4329_bb7d_420453d29edd, xxDummy
 
Fields inherited from interface com.esri.arcgis.carto.IOverposter3
IID, IID75dddcde_ca45_49da_a5c3_7663e2977dd5, xxDummy
 
Fields inherited from interface com.esri.arcgis.carto.IOverposter4
IID, IID655ef2f1_880a_34bb_1dfa_7e00af2e442a, xxDummy
 
Fields inherited from interface com.esri.arcgis.display.IConnectionPointContainer
IID, IIDb196b284_bab4_101a_b69c_00aa00341d07, xxDummy
 
Fields inherited from interface com.esri.arcgis.system.IPersistStream
IID, IID00000109_0000_0000_c000_000000000046, xxDummy
 
Fields inherited from interface com.esri.arcgis.system.IPersist
IID0000010c_0000_0000_c000_000000000046
 
Constructor Summary
BasicOverposter()
          Constructs a BasicOverposter using ArcGIS Engine.
BasicOverposter(java.lang.Object obj)
          Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
BasicOverposter theBasicOverposter = (BasicOverposter) obj;
 
Method Summary
 void addBarriers(int weight, IGeometryCollection barriers)
          Adds a barrier object that placed objects must avoid.
 int addClass(IOverposterLayerProperties props)
          Adds a class to the overposter and specifies its properties.
 int addClass(IOverposterLayerProperties props, ITextSymbol symbol)
          Adds a class to the overposter and specifies its properties.
 void addCurvedLabel(int classIndex, java.lang.String label, java.lang.Object widths, java.lang.Object ascents, java.lang.Object descents, double fontHeight, double fontDescent, IGeometry controlShape, int featureId, ISymbol symbol)
          Adds a curved label object to be placed.
 void addIBasicOverposterEventsListener(IBasicOverposterEvents theListener)
          addIBasicOverposterEventsListener.
 void addLabel(int classIndex, java.lang.String label, double width, double height, IGeometry controlShape, int featureId, ISymbol symbol)
          Adds a label object to be placed.
 void addLabel2(int classIndex, java.lang.String label, double width, double height, IGeometry controlShape, int featureId, ISymbol symbol, double angle)
          Adds a label object to be placed.
 void addSymbol(int classIndex, ISymbol symbol, IGeometry geometry, int featureId)
          Adds a symbol to be placed.
 void enumConnectionPoints(IEnumConnectionPoints[] ppEnum)
          enumConnectionPoints
 boolean equals(java.lang.Object o)
          Compare this object with another
 void findConnectionPoint(GUID riid, IConnectionPoint[] ppCP)
          findConnectionPoint
 int getCapabilities(ILayer layer)
          Overposter capabilities for the specified layer.
 void getClassID(GUID[] pClassID)
          getClassID
static java.lang.String getClsid()
          getClsid.
 com.esri.arcgis.interop.Dispatch getJintegraDispatch()
          Deprecated. Internal use only.
 int getNumberOfPlacedLabels()
          The number of unplaced labels.
 int getNumberOfUnplacedLabels()
          The number of unplaced labels.
 int getNumClasses()
          The number of classes.
 void getSizeMax(_ULARGE_INTEGER[] pcbSize)
          getSizeMax
 int hashCode()
          the hashcode for this object
 void initialize(IEnvelope extent, IDisplay display)
          Initializes the overposter for drawing into the specified area of the map display.
 void initialize(IEnvelope extent, IDisplay display, IOverposterProperties pOverposterProps)
          Initializes the overposter for drawing into the specified area of the map display.
 void insertClass(int index, IOverposterLayerProperties props)
          Inserts a class at a specific index, and specifies its peoperties.
 void isDirty()
          isDirty
 void load(IStream pstm)
          load
 void nextPlaced(IPlacedObject[] object, ITrackCancel trackCancel, IStepProgressor stepProgressor)
          The next object that was successfully placed.
 void nextUnplaced(IPlacedObject[] object)
          The next object that was not successfully placed.
 void nextUnused(IPlacedObject[] object)
          The next object that was not used.
 void placeObjects()
          Places objects using the overposter.
 void readExternal(java.io.ObjectInput in)
           
 void release()
          Release a BasicOverposter.
 void releaseResources()
          Releases current objects from memory.
 void removeClass(int classIndex)
          Removes the class at the specified index from the overposter.
 void removeIBasicOverposterEventsListener(IBasicOverposterEvents theListener)
          removeIBasicOverposterEventsListener.
 void resetClasses()
          Removes all classes from the overposter.
 void save(IStream pstm, int fClearDirty)
          save
 void writeExternal(java.io.ObjectOutput out)
           
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

serialVersionUID

public static final long serialVersionUID
See Also:
Constant Field Values
Constructor Detail

BasicOverposter

public BasicOverposter()
                throws java.io.IOException,
                       java.net.UnknownHostException
Constructs a BasicOverposter using ArcGIS Engine.

Throws:
java.io.IOException - if there are interop problems
java.net.UnknownHostException - if there are interop problems

BasicOverposter

public BasicOverposter(java.lang.Object obj)
                throws java.io.IOException
Deprecated. As of ArcGIS 9.2, replaced by normal Java casts.
BasicOverposter theBasicOverposter = (BasicOverposter) obj;

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

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

getClsid

public static java.lang.String getClsid()
getClsid.


equals

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

Overrides:
equals in class java.lang.Object

hashCode

public int hashCode()
the hashcode for this object

Overrides:
hashCode in class java.lang.Object

getJintegraDispatch

public com.esri.arcgis.interop.Dispatch getJintegraDispatch()
Deprecated. Internal use only.

Specified by:
getJintegraDispatch in interface com.esri.arcgis.interop.RemoteObjRef

addIBasicOverposterEventsListener

public void addIBasicOverposterEventsListener(IBasicOverposterEvents theListener)
                                       throws java.io.IOException
addIBasicOverposterEventsListener. Listen to events generated by this class.

Parameters:
theListener - An object that implements the com.esri.arcgis.carto.IBasicOverposterEvents interface.
Throws:
java.io.IOException - If there are communications problems.

removeIBasicOverposterEventsListener

public void removeIBasicOverposterEventsListener(IBasicOverposterEvents theListener)
                                          throws java.io.IOException
removeIBasicOverposterEventsListener. Stop listening to events generated by this class.

Parameters:
theListener - An object that implements the com.esri.arcgis.carto.IBasicOverposterEvents interface.
Throws:
java.io.IOException - If there are communications problems.

release

public void release()
Release a BasicOverposter.

Specified by:
release in interface com.esri.arcgis.interop.RemoteObjRef

getNumClasses

public int getNumClasses()
                  throws java.io.IOException,
                         AutomationException
The number of classes.

Specified by:
getNumClasses in interface IOverposter
Specified by:
getNumClasses in interface IOverposter2
Specified by:
getNumClasses in interface IOverposter3
Returns:
The count
Throws:
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getCapabilities

public int getCapabilities(ILayer layer)
                    throws java.io.IOException,
                           AutomationException
Overposter capabilities for the specified layer.

Specified by:
getCapabilities in interface IOverposter
Specified by:
getCapabilities in interface IOverposter2
Specified by:
getCapabilities in interface IOverposter3
Parameters:
layer - A reference to a com.esri.arcgis.carto.ILayer (in)
Returns:
A com.esri.arcgis.carto.esriOverposterCaps constant
Throws:
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

addClass

public int addClass(IOverposterLayerProperties props)
             throws java.io.IOException,
                    AutomationException
Adds a class to the overposter and specifies its properties.

Specified by:
addClass in interface IOverposter
Specified by:
addClass in interface IOverposter2
Specified by:
addClass in interface IOverposter3
Parameters:
props - A reference to a com.esri.arcgis.carto.IOverposterLayerProperties (in)
Returns:
The classIndex
Throws:
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

insertClass

public void insertClass(int index,
                        IOverposterLayerProperties props)
                 throws java.io.IOException,
                        AutomationException
Inserts a class at a specific index, and specifies its peoperties.

Specified by:
insertClass in interface IOverposter
Specified by:
insertClass in interface IOverposter2
Specified by:
insertClass in interface IOverposter3
Parameters:
index - The index (in)
props - A reference to a com.esri.arcgis.carto.IOverposterLayerProperties (in)
Throws:
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

removeClass

public void removeClass(int classIndex)
                 throws java.io.IOException,
                        AutomationException
Removes the class at the specified index from the overposter.

Specified by:
removeClass in interface IOverposter
Specified by:
removeClass in interface IOverposter2
Specified by:
removeClass in interface IOverposter3
Parameters:
classIndex - The classIndex (in)
Throws:
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

resetClasses

public void resetClasses()
                  throws java.io.IOException,
                         AutomationException
Removes all classes from the overposter.

Specified by:
resetClasses in interface IOverposter
Specified by:
resetClasses in interface IOverposter2
Specified by:
resetClasses in interface IOverposter3
Throws:
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

initialize

public void initialize(IEnvelope extent,
                       IDisplay display)
                throws java.io.IOException,
                       AutomationException
Initializes the overposter for drawing into the specified area of the map display.

Specified by:
initialize in interface IOverposter
Specified by:
initialize in interface IOverposter2
Parameters:
extent - A reference to a com.esri.arcgis.geometry.IEnvelope (in)
display - A reference to a com.esri.arcgis.display.IDisplay (in)
Throws:
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

addBarriers

public void addBarriers(int weight,
                        IGeometryCollection barriers)
                 throws java.io.IOException,
                        AutomationException
Adds a barrier object that placed objects must avoid.

Specified by:
addBarriers in interface IOverposter
Specified by:
addBarriers in interface IOverposter2
Specified by:
addBarriers in interface IOverposter3
Parameters:
weight - A com.esri.arcgis.carto.esriBasicOverposterWeight constant (in)
barriers - A reference to a com.esri.arcgis.geometry.IGeometryCollection (in)
Throws:
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

addLabel

public void addLabel(int classIndex,
                     java.lang.String label,
                     double width,
                     double height,
                     IGeometry controlShape,
                     int featureId,
                     ISymbol symbol)
              throws java.io.IOException,
                     AutomationException
Adds a label object to be placed.

Specified by:
addLabel in interface IOverposter
Specified by:
addLabel in interface IOverposter2
Specified by:
addLabel in interface IOverposter3
Parameters:
classIndex - The classIndex (in)
label - The label (in)
width - The width (in)
height - The height (in)
controlShape - A reference to a com.esri.arcgis.geometry.IGeometry (in)
featureId - The featureId (in)
symbol - A reference to a com.esri.arcgis.display.ISymbol (in)
Throws:
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

addCurvedLabel

public void addCurvedLabel(int classIndex,
                           java.lang.String label,
                           java.lang.Object widths,
                           java.lang.Object ascents,
                           java.lang.Object descents,
                           double fontHeight,
                           double fontDescent,
                           IGeometry controlShape,
                           int featureId,
                           ISymbol symbol)
                    throws java.io.IOException,
                           AutomationException
Adds a curved label object to be placed.

Specified by:
addCurvedLabel in interface IOverposter
Specified by:
addCurvedLabel in interface IOverposter2
Specified by:
addCurvedLabel in interface IOverposter3
Parameters:
classIndex - The classIndex (in)
label - The label (in)
widths - A Variant (in)
ascents - A Variant (in)
descents - A Variant (in)
fontHeight - The fontHeight (in)
fontDescent - The fontDescent (in)
controlShape - A reference to a com.esri.arcgis.geometry.IGeometry (in)
featureId - The featureId (in)
symbol - A reference to a com.esri.arcgis.display.ISymbol (in)
Throws:
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

addSymbol

public void addSymbol(int classIndex,
                      ISymbol symbol,
                      IGeometry geometry,
                      int featureId)
               throws java.io.IOException,
                      AutomationException
Adds a symbol to be placed.

Specified by:
addSymbol in interface IOverposter
Specified by:
addSymbol in interface IOverposter2
Specified by:
addSymbol in interface IOverposter3
Parameters:
classIndex - The classIndex (in)
symbol - A reference to a com.esri.arcgis.display.ISymbol (in)
geometry - A reference to a com.esri.arcgis.geometry.IGeometry (in)
featureId - The featureId (in)
Throws:
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

placeObjects

public void placeObjects()
                  throws java.io.IOException,
                         AutomationException
Places objects using the overposter.

Specified by:
placeObjects in interface IOverposter
Specified by:
placeObjects in interface IOverposter2
Specified by:
placeObjects in interface IOverposter3
Throws:
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

nextPlaced

public void nextPlaced(IPlacedObject[] object,
                       ITrackCancel trackCancel,
                       IStepProgressor stepProgressor)
                throws java.io.IOException,
                       AutomationException
The next object that was successfully placed.

Specified by:
nextPlaced in interface IOverposter
Specified by:
nextPlaced in interface IOverposter2
Specified by:
nextPlaced in interface IOverposter3
Parameters:
object - A reference to a com.esri.arcgis.carto.IPlacedObject (in/out: use single element array)
trackCancel - A reference to a com.esri.arcgis.system.ITrackCancel (in)
stepProgressor - A reference to a com.esri.arcgis.system.IStepProgressor (in)
Throws:
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

nextUnplaced

public void nextUnplaced(IPlacedObject[] object)
                  throws java.io.IOException,
                         AutomationException
The next object that was not successfully placed.

Specified by:
nextUnplaced in interface IOverposter
Specified by:
nextUnplaced in interface IOverposter2
Specified by:
nextUnplaced in interface IOverposter3
Parameters:
object - A reference to a com.esri.arcgis.carto.IPlacedObject (out: use single element array)
Throws:
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

nextUnused

public void nextUnused(IPlacedObject[] object)
                throws java.io.IOException,
                       AutomationException
The next object that was not used.

Specified by:
nextUnused in interface IOverposter
Specified by:
nextUnused in interface IOverposter2
Specified by:
nextUnused in interface IOverposter3
Parameters:
object - A reference to a com.esri.arcgis.carto.IPlacedObject (out: use single element array)
Throws:
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

releaseResources

public void releaseResources()
                      throws java.io.IOException,
                             AutomationException
Releases current objects from memory.

Specified by:
releaseResources in interface IOverposter
Specified by:
releaseResources in interface IOverposter2
Specified by:
releaseResources in interface IOverposter3
Throws:
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getNumberOfUnplacedLabels

public int getNumberOfUnplacedLabels()
                              throws java.io.IOException,
                                     AutomationException
The number of unplaced labels. Only valid after calling PlaceObjects.

Specified by:
getNumberOfUnplacedLabels in interface IOverposter
Specified by:
getNumberOfUnplacedLabels in interface IOverposter2
Specified by:
getNumberOfUnplacedLabels in interface IOverposter3
Returns:
The count
Throws:
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getNumberOfPlacedLabels

public int getNumberOfPlacedLabels()
                            throws java.io.IOException,
                                   AutomationException
The number of unplaced labels. Only valid after calling PlaceObjects.

Specified by:
getNumberOfPlacedLabels in interface IOverposter
Specified by:
getNumberOfPlacedLabels in interface IOverposter2
Specified by:
getNumberOfPlacedLabels in interface IOverposter3
Returns:
The count
Throws:
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

addLabel2

public void addLabel2(int classIndex,
                      java.lang.String label,
                      double width,
                      double height,
                      IGeometry controlShape,
                      int featureId,
                      ISymbol symbol,
                      double angle)
               throws java.io.IOException,
                      AutomationException
Adds a label object to be placed.

Specified by:
addLabel2 in interface IOverposter2
Specified by:
addLabel2 in interface IOverposter3
Parameters:
classIndex - The classIndex (in)
label - The label (in)
width - The width (in)
height - The height (in)
controlShape - A reference to a com.esri.arcgis.geometry.IGeometry (in)
featureId - The featureId (in)
symbol - A reference to a com.esri.arcgis.display.ISymbol (in)
angle - The angle (in)
Throws:
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

initialize

public void initialize(IEnvelope extent,
                       IDisplay display,
                       IOverposterProperties pOverposterProps)
                throws java.io.IOException,
                       AutomationException
Initializes the overposter for drawing into the specified area of the map display.

Specified by:
initialize in interface IOverposter3
Parameters:
extent - A reference to a com.esri.arcgis.geometry.IEnvelope (in)
display - A reference to a com.esri.arcgis.display.IDisplay (in)
pOverposterProps - A reference to a com.esri.arcgis.carto.IOverposterProperties (in)
Throws:
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

addClass

public int addClass(IOverposterLayerProperties props,
                    ITextSymbol symbol)
             throws java.io.IOException,
                    AutomationException
Adds a class to the overposter and specifies its properties.

Specified by:
addClass in interface IOverposter4
Parameters:
props - A reference to a com.esri.arcgis.carto.IOverposterLayerProperties (in)
symbol - A reference to a com.esri.arcgis.display.ITextSymbol (in)
Returns:
The classIndex
Throws:
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

enumConnectionPoints

public void enumConnectionPoints(IEnumConnectionPoints[] ppEnum)
                          throws java.io.IOException,
                                 AutomationException
enumConnectionPoints

Specified by:
enumConnectionPoints in interface IConnectionPointContainer
Parameters:
ppEnum - A reference to a com.esri.arcgis.display.IEnumConnectionPoints (out: use single element array)
Throws:
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

findConnectionPoint

public void findConnectionPoint(GUID riid,
                                IConnectionPoint[] ppCP)
                         throws java.io.IOException,
                                AutomationException
findConnectionPoint

Specified by:
findConnectionPoint in interface IConnectionPointContainer
Parameters:
riid - A Structure: com.esri.arcgis.support.ms.stdole.GUID (in)
ppCP - A reference to a com.esri.arcgis.display.IConnectionPoint (out: use single element array)
Throws:
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getClassID

public void getClassID(GUID[] pClassID)
                throws java.io.IOException,
                       AutomationException
getClassID

Specified by:
getClassID in interface IPersist
Parameters:
pClassID - A Structure: com.esri.arcgis.support.ms.stdole.GUID (out: use single element array)
Throws:
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isDirty

public void isDirty()
             throws java.io.IOException,
                    AutomationException
isDirty

Specified by:
isDirty in interface IPersistStream
Throws:
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

load

public void load(IStream pstm)
          throws java.io.IOException,
                 AutomationException
load

Specified by:
load in interface IPersistStream
Parameters:
pstm - A reference to a com.esri.arcgis.system.IStream (in)
Throws:
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

save

public void save(IStream pstm,
                 int fClearDirty)
          throws java.io.IOException,
                 AutomationException
save

Specified by:
save in interface IPersistStream
Parameters:
pstm - A reference to a com.esri.arcgis.system.IStream (in)
fClearDirty - The fClearDirty (in)
Throws:
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getSizeMax

public void getSizeMax(_ULARGE_INTEGER[] pcbSize)
                throws java.io.IOException,
                       AutomationException
getSizeMax

Specified by:
getSizeMax in interface IPersistStream
Parameters:
pcbSize - A Structure: com.esri.arcgis.system._ULARGE_INTEGER (out: use single element array)
Throws:
java.io.IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

writeExternal

public void writeExternal(java.io.ObjectOutput out)
                   throws java.io.IOException
Specified by:
writeExternal in interface java.io.Externalizable
Throws:
java.io.IOException

readExternal

public void readExternal(java.io.ObjectInput in)
                  throws java.io.IOException,
                         java.lang.ClassNotFoundException
Specified by:
readExternal in interface java.io.Externalizable
Throws:
java.io.IOException
java.lang.ClassNotFoundException