com.esri.arcgis.trackinganalyst
Interface ITemporalLegendGroup

All Superinterfaces:

Serializable

All Known Subinterfaces:

ITemporalLegendGroup2

All Known Implementing Classes:

TemporalLegendGroup

public interface ITemporalLegendGroup
extends Serializable

Provides access to properties and methods needed to manage the temporal legend group of classes.

Description

The Temporal Legend contains rules on how to render symbology with temporal characteristics.

Product Availability

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

Method Summary

void	addClass(ILegendClass legendClass) Adds a new legend class to the group at the end of list.
void	clearClasses() Removes all classes from the group.
ILegendClass	esri_getClass(int index) Legend class at the specified index.
int	getClassCount() Number of legend classes in the group.
String	getColorRampName() Esri pre-defined color ramp last used by the temporal renderer property page to update this object; this value is used to create default temporal legend class symbology colors.
String	getDescription() Text description of the temporal legend group.
String	getHeading() String heading.
ITemporalLegendClass	getTemporalLegendClass(int nRangeNdx) Temporal Legend Class at specified index from this group.
void	insertClass(int index, ILegendClass legendClass) Inserts a new legend class into the group at the specified index.
int	intersects(Object pvTimeValue, ISymbol[] ppiSymbol, IColor[] ppiSymbolColor, double[] pdSymbolSize) Determines whether a given timestamp value is contained within one of the group's temporal classes.
boolean	isEditable() Indicates if the group can be edited.
boolean	isSuppress() Controls whether or not to use the temporal legend classes during intersect or time period computation for a temporal query.
boolean	isVisible() Indicates if the group is displayed.
void	moveClass(int nCurrentIndex, int nDestinationIndex) Moves a temporal legend class from its current position to a new destination within the temporal legend group's legend class container.
void	removeClass(int index) Removes the legend class from the group at the specified index.
void	setColorRampName(String pbstrColorRampName) Esri pre-defined color ramp last used by the temporal renderer property page to update this object; this value is used to create default temporal legend class symbology colors.
void	setDescription(String pbstrDescription) Text description of the temporal legend group.
void	setEditable(boolean editable) Indicates if the group can be edited.
void	setHeading(String heading) String heading.
void	setReference(Object varReference) Sets temporal reference information for the temporal legend group.
void	setSuppress(boolean pbSuppress) Controls whether or not to use the temporal legend classes during intersect or time period computation for a temporal query.
void	setVisible(boolean visible) Indicates if the group is displayed.
void	update() Updates the temporal legend with new values.
void	verify(boolean[] bNoProblems) Checks ranges within a group to determine if group is ordered properly and has correct offsets.

Method Detail

isVisible

boolean isVisible()
                  throws IOException,
                         AutomationException

Indicates if the group is displayed.

Product Availability

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

Returns:

The visible

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setVisible

void setVisible(boolean visible)
                throws IOException,
                       AutomationException

Indicates if the group is displayed.

Product Availability

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

Parameters:

visible - The visible (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isEditable

boolean isEditable()
                   throws IOException,
                          AutomationException

Indicates if the group can be edited. Default is editable.

Product Availability

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

Returns:

The editable

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setEditable

void setEditable(boolean editable)
                 throws IOException,
                        AutomationException

Indicates if the group can be edited. Default is editable.

Product Availability

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

Parameters:

editable - The editable (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getHeading

String getHeading()
                  throws IOException,
                         AutomationException

String heading.

Description

The property indicates the string heading for the legend group.

Product Availability

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

Returns:

The heading

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setHeading

void setHeading(String heading)
                throws IOException,
                       AutomationException

String heading.

Product Availability

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

Parameters:

heading - The heading (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getClassCount

int getClassCount()
                  throws IOException,
                         AutomationException

Number of legend classes in the group.

Product Availability

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

Returns:

The count

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

esri_getClass

ILegendClass esri_getClass(int index)
                           throws IOException,
                                  AutomationException

Legend class at the specified index.

Product Availability

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

Parameters:

index - The index (in)

Returns:

A reference to a com.esri.arcgis.carto.ILegendClass

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

addClass

void addClass(ILegendClass legendClass)
              throws IOException,
                     AutomationException

Adds a new legend class to the group at the end of list.

Product Availability

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

Parameters:

legendClass - A reference to a com.esri.arcgis.carto.ILegendClass (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

insertClass

void insertClass(int index,
                 ILegendClass legendClass)
                 throws IOException,
                        AutomationException

Inserts a new legend class into the group at the specified index.

Product Availability

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

Parameters:

index - The index (in)

legendClass - A reference to a com.esri.arcgis.carto.ILegendClass (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

removeClass

void removeClass(int index)
                 throws IOException,
                        AutomationException

Removes the legend class from the group at the specified index.

Product Availability

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

Parameters:

index - The index (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

clearClasses

void clearClasses()
                  throws IOException,
                         AutomationException

Removes all classes from the group.

Product Availability

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getColorRampName

String getColorRampName()
                        throws IOException,
                               AutomationException

Esri pre-defined color ramp last used by the temporal renderer property page to update this object; this value is used to create default temporal legend class symbology colors.

Description

The Color Ramp Name property is the name of an ESRI pre-defined color ramp that was last used by the TemporalRenderer property page that updated this object. This value is used to create default temporal legend class symbology colors. This property is the name of an ESRI color ramp obtained from ESRI's pre-defined color ramps. The Temporal Renderer's property page uses this property to obtain the color ramp in order to build default temporal legend classes and symbology for the legend classes' symbols.

Product Availability

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

Returns:

The pbstrColorRampName

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setColorRampName

void setColorRampName(String pbstrColorRampName)
                      throws IOException,
                             AutomationException

Esri pre-defined color ramp last used by the temporal renderer property page to update this object; this value is used to create default temporal legend class symbology colors.

Description

The Color Ramp Name property is the name of an ESRI pre-defined color ramp that was last used by the TemporalRenderer property page that updated this object. This value is used to create default temporal legend class symbology colors. This property is the name of an ESRI color ramp obtained from ESRI's pre-defined color ramps. The Temporal Renderer's property page uses this property to obtain the color ramp in order to build default temporal legend classes and symbology for the legend classes' symbols.

Product Availability

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

Parameters:

pbstrColorRampName - The pbstrColorRampName (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getDescription

String getDescription()
                      throws IOException,
                             AutomationException

Text description of the temporal legend group.

Description

The Description property contains a description of this Temporal Group. This is the same property as Heading from ILegendGroup.

Product Availability

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

Returns:

The pbstrDescription

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setDescription

void setDescription(String pbstrDescription)
                    throws IOException,
                           AutomationException

Text description of the temporal legend group.

Description

The Description property contains a description of this Temporal Group. This is the same property as Heading from ILegendGroup.

Product Availability

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

Parameters:

pbstrDescription - The pbstrDescription (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getTemporalLegendClass

ITemporalLegendClass getTemporalLegendClass(int nRangeNdx)
                                            throws IOException,
                                                   AutomationException

Temporal Legend Class at specified index from this group.

Product Availability

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

Parameters:

nRangeNdx - The nRangeNdx (in)

Returns:

A reference to a com.esri.arcgis.trackinganalyst.ITemporalLegendClass

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

isSuppress

boolean isSuppress()
                   throws IOException,
                          AutomationException

Controls whether or not to use the temporal legend classes during intersect or time period computation for a temporal query.

Description

The Suppress property controls whether or not to use the temporal legend classes during intersect or computation of the time period needed for a temporal query.

Product Availability

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

Returns:

The pbSuppress

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setSuppress

void setSuppress(boolean pbSuppress)
                 throws IOException,
                        AutomationException

Controls whether or not to use the temporal legend classes during intersect or time period computation for a temporal query.

Description

The Suppress property controls whether or not to use the temporal legend classes during intersect or computation of the time period needed for a temporal query.

Product Availability

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

Parameters:

pbSuppress - The pbSuppress (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setReference

void setReference(Object varReference)
                  throws IOException,
                         AutomationException

Sets temporal reference information for the temporal legend group.

Product Availability

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

Parameters:

varReference - A Variant (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

intersects

int intersects(Object pvTimeValue,
               ISymbol[] ppiSymbol,
               IColor[] ppiSymbolColor,
               double[] pdSymbolSize)
               throws IOException,
                      AutomationException

Determines whether a given timestamp value is contained within one of the group's temporal classes.

Description

This method determines if a given absolute time, timestamp, is contained within one of this class's temporal legend classes. If so it returns the index of
the legend class that should be used, and it returns the associated symbol for that temporal legend class.

Product Availability

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

Parameters:

pvTimeValue - A Variant (in)

ppiSymbol - A reference to a com.esri.arcgis.display.ISymbol (in/out: use single element array)

ppiSymbolColor - A reference to a com.esri.arcgis.display.IColor (in/out: use single element array)

pdSymbolSize - The pdSymbolSize (in/out: use single element array)

Returns:

The pnUseSymbol

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

update

void update()
            throws IOException,
                   AutomationException

Updates the temporal legend with new values.

Description

The Update method updates the legend. Each temporal range in this legend calls this method to have the temporal legend update the ranges in order to maintain a sorted range list from future to past/normal and compute the correct offsets.

Product Availability

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

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

moveClass

void moveClass(int nCurrentIndex,
               int nDestinationIndex)
               throws IOException,
                      AutomationException

Moves a temporal legend class from its current position to a new destination within the temporal legend group's legend class container.

Description

The move Class method moves a Temporal Legend Class from the current position to the destination position within the Temporal Legend Groups Legend Class container.

Product Availability

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

Parameters:

nCurrentIndex - The nCurrentIndex (in)

nDestinationIndex - The nDestinationIndex (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

verify

void verify(boolean[] bNoProblems)
            throws IOException,
                   AutomationException

Checks ranges within a group to determine if group is ordered properly and has correct offsets.

Description

The verify method checks the ranges within a group to determine if the group is ordered properly and has correct offsets. It does not fix any detected problems; it only returns a boolean result.

Product Availability

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

Parameters:

bNoProblems - The bNoProblems (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.