com.esri.arcgis.trackinganalyst
Class ITAUpdateControlProxy

java.lang.Object
  extended by com.esri.arcgis.interop.Dispatch
      extended by com.esri.arcgis.trackinganalyst.ITAUpdateControlProxy
All Implemented Interfaces:
ITAUpdateControl, Externalizable, Serializable

public class ITAUpdateControlProxy
extends com.esri.arcgis.interop.Dispatch
implements ITAUpdateControl, Serializable

Provides access to methods needed to manage the dynamic updating of events drawn in ArcMap.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

See Also:
Serialized Form

Field Summary
 
Fields inherited from class com.esri.arcgis.interop.Dispatch
DISPATCH_METHOD, DISPATCH_PROPERTYGET, DISPATCH_PROPERTYPUT, DISPATCH_PROPERTYPUTREF, E
 
Constructor Summary
  ITAUpdateControlProxy()
           
  ITAUpdateControlProxy(Object obj)
           
protected ITAUpdateControlProxy(Object obj, String iid)
           
 
Method Summary
 void addLayer(ILayer piLayer)
          Obsolete Method that is unsupported.
 void addListener(String iidStr, Object theListener, Object theSource)
           
 double getMaxUpdateRate()
          Indicates the minimum duration between which the map display updates, as defined in the dynamic update controller.
 double getRefreshRate()
          Indicates the maximum duration between map display refreshes, as defined in the dynamic update controller.
 String getStatistics()
          Various statistics about dynamic display processing.
 int getUpdateMethod()
          Defines how the display refresh is determined: by number of points or CPU usage.
 int getUpdateValue()
          Indicates the number of points or percentage of CPU usage used as the threshold for a map display refresh.
 boolean isAutoRefresh()
          Indicates whether or not the map display will refresh automatically when no new data has been received.
 boolean isManualUpdate()
          Indicates whether or not map display must be updated manually when new data is received.
 void readExternal(ObjectInput in)
           
 void refreshDisplay(int enumUpdateType)
          Refreshes the map display in ArcMap.
 void removeLayer(ILayer piLayer)
          Obsolete Method that is unsupported.
 void removeListener(String iidStr, Object theListener)
           
 void setAutoRefresh(boolean pVal)
          Indicates whether or not the map display will refresh automatically when no new data has been received.
 void setManualUpdate(boolean pVal)
          Indicates whether or not map display must be updated manually when new data is received.
 void setMaxUpdateRate(double pVal)
          Indicates the minimum duration between which the map display updates, as defined in the dynamic update controller.
 void setRefreshRate(double pVal)
          Indicates the maximum duration between map display refreshes, as defined in the dynamic update controller.
 void setUpdateMethod(int pVal)
          Defines how the display refresh is determined: by number of points or CPU usage.
 void setUpdateValue(int pVal)
          Indicates the number of points or percentage of CPU usage used as the threshold for a map display refresh.
 void writeExternal(ObjectOutput out)
           
 
Methods inherited from class com.esri.arcgis.interop.Dispatch
bindUsingMoniker, constructVtblPosTable, convertToNative, cookieForListener, createDispatch, createObjrefMonikerDisplayName, equals, getActiveObject, getActiveObject, getDefaultProperty, getDispatchIdOfName, getLastErrorCode, getMtsObjectContext, getObjRef, getPropertyByName, getPropertyByName, getVtblPos, hashCode, initDispatch, invoke, invokeMethodByName, invokeMethodByName, invokeMethodByName, invokePropertyGetByName, invokePropertyPutByName, invokePropertyPutByRefByName, isNativeMode, isObjRef, queryInterface, release, setNativeMode, setPropertyByName, toString, vtblInvoke
 
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

Constructor Detail

ITAUpdateControlProxy

public ITAUpdateControlProxy()

ITAUpdateControlProxy

public ITAUpdateControlProxy(Object obj)
                      throws IOException
Throws:
IOException

ITAUpdateControlProxy

protected ITAUpdateControlProxy(Object obj,
                                String iid)
                         throws IOException
Throws:
IOException
Method Detail

addListener

public void addListener(String iidStr,
                        Object theListener,
                        Object theSource)
                 throws IOException
Overrides:
addListener in class com.esri.arcgis.interop.Dispatch
Throws:
IOException

removeListener

public void removeListener(String iidStr,
                           Object theListener)
                    throws IOException
Overrides:
removeListener in class com.esri.arcgis.interop.Dispatch
Throws:
IOException

addLayer

public void addLayer(ILayer piLayer)
              throws IOException,
                     AutomationException
Obsolete Method that is unsupported.

Description

This method adds a layer to the Display update controller. Only temporal layers are permitted. If a non-temporal layer is added it is rejected and S_False is returned.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
addLayer in interface ITAUpdateControl
Parameters:
piLayer - A reference to a com.esri.arcgis.carto.ILayer (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

removeLayer

public void removeLayer(ILayer piLayer)
                 throws IOException,
                        AutomationException
Obsolete Method that is unsupported.

Description

This method removes a layer from the Controller's management.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
removeLayer in interface ITAUpdateControl
Parameters:
piLayer - A reference to a com.esri.arcgis.carto.ILayer (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getRefreshRate

public double getRefreshRate()
                      throws IOException,
                             AutomationException
Indicates the maximum duration between map display refreshes, as defined in the dynamic update controller.

Description

Gets and sets the maximum number of seconds between map refreshes if no new data has been received when AutoRefresh is enabled on the dynamic update controller. If no new data has been received to trigger an update refresh this timer will cause the map to refresh. This is important for maintaining time windows and aging. The RefreshRate must be greater than or equal to the MaxUpdateRate and less than or equal to 500 seconds.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getRefreshRate in interface ITAUpdateControl
Returns:
The pVal
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setRefreshRate

public void setRefreshRate(double pVal)
                    throws IOException,
                           AutomationException
Indicates the maximum duration between map display refreshes, as defined in the dynamic update controller.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

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

getMaxUpdateRate

public double getMaxUpdateRate()
                        throws IOException,
                               AutomationException
Indicates the minimum duration between which the map display updates, as defined in the dynamic update controller.

Description

Gets and sets the minimum number of seconds between map refreshes when real-time data is being received and AutoRefresh is enabled. The MaxUpdateRate must be between 0.5 and 60 seconds. This timer is triggered only if new data has been received since the last refresh. If data stops being received for an extended period the timer specified by the RefreshRate property will execute to maintain temporal windows and aging.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getMaxUpdateRate in interface ITAUpdateControl
Returns:
The pVal
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setMaxUpdateRate

public void setMaxUpdateRate(double pVal)
                      throws IOException,
                             AutomationException
Indicates the minimum duration between which the map display updates, as defined in the dynamic update controller.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

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

refreshDisplay

public void refreshDisplay(int enumUpdateType)
                    throws IOException,
                           AutomationException
Refreshes the map display in ArcMap.

Remarks

There are five types of screen updates available:

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
refreshDisplay in interface ITAUpdateControl
Parameters:
enumUpdateType - A com.esri.arcgis.trackinganalyst.enumScreenUpdateType constant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getUpdateMethod

public int getUpdateMethod()
                    throws IOException,
                           AutomationException
Defines how the display refresh is determined: by number of points or CPU usage.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getUpdateMethod in interface ITAUpdateControl
Returns:
A com.esri.arcgis.trackinganalyst.enumScreenUpdateThresholdType constant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setUpdateMethod

public void setUpdateMethod(int pVal)
                     throws IOException,
                            AutomationException
Defines how the display refresh is determined: by number of points or CPU usage.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
setUpdateMethod in interface ITAUpdateControl
Parameters:
pVal - A com.esri.arcgis.trackinganalyst.enumScreenUpdateThresholdType constant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getUpdateValue

public int getUpdateValue()
                   throws IOException,
                          AutomationException
Indicates the number of points or percentage of CPU usage used as the threshold for a map display refresh.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getUpdateValue in interface ITAUpdateControl
Returns:
The pVal
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setUpdateValue

public void setUpdateValue(int pVal)
                    throws IOException,
                           AutomationException
Indicates the number of points or percentage of CPU usage used as the threshold for a map display refresh.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

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

getStatistics

public String getStatistics()
                     throws IOException,
                            AutomationException
Various statistics about dynamic display processing.

Description

This method returns a XML string containing named variables of various statistics about display processing for temporal data.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
getStatistics in interface ITAUpdateControl
Returns:
The pbstrXMLData
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

isManualUpdate

public boolean isManualUpdate()
                       throws IOException,
                              AutomationException
Indicates whether or not map display must be updated manually when new data is received.

Remarks

If ManualUpdate is set to true then you are responsible for causing map refreshes to animate the display of tracking data. The primary mechanism to cause a screen refresh is using RefreshDisplay. you can also using IActiveView::Refresh and IActiveView::PartialRefresh, but they are not as optimized for updating tracking data.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
isManualUpdate in interface ITAUpdateControl
Returns:
The pVal
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setManualUpdate

public void setManualUpdate(boolean pVal)
                     throws IOException,
                            AutomationException
Indicates whether or not map display must be updated manually when new data is received.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

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

isAutoRefresh

public boolean isAutoRefresh()
                      throws IOException,
                             AutomationException
Indicates whether or not the map display will refresh automatically when no new data has been received.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

Specified by:
isAutoRefresh in interface ITAUpdateControl
Returns:
The pVal
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setAutoRefresh

public void setAutoRefresh(boolean pVal)
                    throws IOException,
                           AutomationException
Indicates whether or not the map display will refresh automatically when no new data has been received.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Tracking Analyst Extension.

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

writeExternal

public void writeExternal(ObjectOutput out)
                   throws IOException
Specified by:
writeExternal in interface Externalizable
Overrides:
writeExternal in class com.esri.arcgis.interop.Dispatch
Throws:
IOException

readExternal

public void readExternal(ObjectInput in)
                  throws IOException,
                         ClassNotFoundException
Specified by:
readExternal in interface Externalizable
Overrides:
readExternal in class com.esri.arcgis.interop.Dispatch
Throws:
IOException
ClassNotFoundException