com.esri.arcgis.display
Interface ISymbolArray

All Superinterfaces:

Serializable

All Known Implementing Classes:

BarChartSymbol, DotDensityFillSymbol, PieChartSymbol, StackedChartSymbol

public interface ISymbolArray
extends Serializable

Provides access to members that work with an array of symbols.

Remarks

You can use this interface to work with the properties of a data driven symbol that is comprised of other symbols. Chart symbols are an example of a data driven symbol, as are dot density fill symbols. These symbols are designed only to be used by a ChartRenderer and a DotDensityRenderer respectively.

ISymbolArray is a generic interface that provides access to members that manage the individual symbols that make up the data driven symbols mentioned above. For example, for a PieChartSymbol, Symbol(i) provides access to the fill symbol for the ith pie slice. When rendered, this slice is mapped to a particular field in the data whose value for a particular feature determines the size of the pie slice. For a dot density renderer, Symbol(i) represents the marker symbol used to represent the density of values in the ith field added to the DotDensityRenderer.

You can use MoveSymbol to change the order of the individual symbols that make up a chart symbol or dot density fill symbol. For example, changing the order of symbols for a BarChartSymbol changes the order that bars/columns will appear on the map.

Product Availability

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

Method Summary

void	addSymbol(ISymbol symbol) Adds a symbol to the array.
void	clearSymbols() Removes all symbols from the array.
void	deleteSymbol(ISymbol symbol) Delete the given symbol.
ISymbol	getSymbol(int index) The symbol at the index position.
int	getSymbolCount() The number of symbols.
void	moveSymbol(ISymbol symbol, int toIndex) Moves the given symbol to new index position.
void	setSymbolByRef(int index, ISymbol symbol) The symbol at the index position.

Method Detail

getSymbolCount

int getSymbolCount()
                   throws IOException,
                          AutomationException

The number of symbols.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:

The count

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

getSymbol

ISymbol getSymbol(int index)
                  throws IOException,
                         AutomationException

The symbol at the index position.

Product Availability

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

Parameters:

index - The index (in)

Returns:

A reference to a com.esri.arcgis.display.ISymbol

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

setSymbolByRef

void setSymbolByRef(int index,
                    ISymbol symbol)
                    throws IOException,
                           AutomationException

The symbol at the index position.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

index - The index (in)

symbol - A reference to a com.esri.arcgis.display.ISymbol (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

addSymbol

void addSymbol(ISymbol symbol)
               throws IOException,
                      AutomationException

Adds a symbol to the array.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

symbol - A reference to a com.esri.arcgis.display.ISymbol (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

deleteSymbol

void deleteSymbol(ISymbol symbol)
                  throws IOException,
                         AutomationException

Delete the given symbol.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

symbol - A reference to a com.esri.arcgis.display.ISymbol (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

moveSymbol

void moveSymbol(ISymbol symbol,
                int toIndex)
                throws IOException,
                       AutomationException

Moves the given symbol to new index position.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:

symbol - A reference to a com.esri.arcgis.display.ISymbol (in)

toIndex - The toIndex (in)

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.

clearSymbols

void clearSymbols()
                  throws IOException,
                         AutomationException

Removes all symbols from the array.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Throws:

IOException - If there are interop problems.

AutomationException - If the ArcObject component throws an exception.