com.esri.core.map
Class Graphic

java.lang.Object
  com.esri.core.map.Graphic

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

StopGraphic

public class Graphic
extends Object
implements Serializable

The Graphic class is used to represent a feature that can have any of the following types:

• Geometry
• Symbol
• attributes
• InfoTemplate

Graphic objects are immutable, which means its state cannot change after construction. When a Graphic object is added to a GraphicsLayer via the GraphicsLayer#addGraphic(Graphic) method, this method returns a unique ID (UID) which you can then use to reference the added graphic for subsequent operations. Graphic objects are stateless so there is no guarantee that a feature in the GraphicsLayer exists after the request for the Graphic object is completed.

Graphic objects can be displayed, altered and removed using a GraphicsLayer (see the GraphicsLayer class for more details)

Since:

1.0

See Also:

Serialized Form

Field Summary

protected Map<String,Object>

attributes Name-value pairs of fields and their connected field values that are associated with the graphic.

Constructor Summary

Graphic(Geometry geometry, Symbol symbol)
Instantiates a new Graphic object.

Graphic(Geometry geometry, Symbol symbol, int drawOrder)
Instantiates a new Graphic object.

Graphic(Geometry geometry, Symbol symbol, Map<String,Object> attributes, InfoTemplate infoTemp)
Instantiates a new Graphic object.

Graphic(Geometry geometry, Symbol symbol, Map<String,Object> attributes, int drawOrder)

Method Summary

static Graphic	fromJson(org.codehaus.jackson.JsonParser parser) Convenient method which parses the JSON representation of a graphic into a graphic object.
String[]	getAttributeNames() Gets the name of all the attributes.
Map<String,Object>	getAttributes() Returns all attributes of the graphic as a read-only collection.
Object	getAttributeValue(String key) Gets the attribute value by the given name.
int	getDrawOrder() Returns the draw order.
Geometry	getGeometry() Gets the geometry that defines the graphic.
InfoTemplate	getInfoTemplate() Deprecated.
SpatialReference	getSpatialReference() Returns the spatial reference.
Symbol	getSymbol() Gets the symbol for the graphic.
int	getUid() Gets unique ID.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

attributes

protected final Map<String,Object> attributes

Name-value pairs of fields and their connected field values that are associated with the graphic.

Constructor Detail

Graphic

public Graphic(Geometry geometry,
               Symbol symbol)

Instantiates a new Graphic object.

Parameters:

geometry - the geometry to draw;

symbol - the symbol to draw the geometry with.

Since:

1.0

Graphic

public Graphic(Geometry geometry,
               Symbol symbol,
               int drawOrder)

Instantiates a new Graphic object.

Parameters:

geometry - the geometry to draw;

symbol - the symbol to draw the geometry with.

drawOrder - the draw order; higher valued graphics appear on top of lower valued graphics.

Since:

10.1.1

Graphic

public Graphic(Geometry geometry,
               Symbol symbol,
               Map<String,Object> attributes,
               InfoTemplate infoTemp)

Instantiates a new Graphic object. The uid defaults to -1.

Parameters:

geometry - The geometry to draw.

symbol - The symbol to draw the geometry with.

attributes - The name-value pairs of fields and their connected field values that are associated with the graphic.

infoTemp - The InfoTemplate object.

Since:

1.0

Graphic

public Graphic(Geometry geometry,
               Symbol symbol,
               Map<String,Object> attributes,
               int drawOrder)

Parameters:

geometry - The geometry to draw.

symbol - The symbol to draw the geometry with.

attributes - The name-value pairs of fields and their connected field values that are associated with the graphic.

drawOrder - the draw order; higher valued graphics appear on top of lower valued graphics.

Since:

10.1.1

Method Detail

getUid

public int getUid()

Gets unique ID.

Returns:

the uid

Since:

1.0

getSymbol

public Symbol getSymbol()

Gets the symbol for the graphic.

Returns:

the symbol

Since:

1.0

getGeometry

public Geometry getGeometry()

Gets the geometry that defines the graphic.

Returns:

the geometry

Since:

1.0

getAttributeNames

public String[] getAttributeNames()

Gets the name of all the attributes. Attributes are name-value pairs of fields and field values associated with the graphic.

Returns:

the attribute names

Since:

1.0

getAttributeValue

public Object getAttributeValue(String key)

Gets the attribute value by the given name.

Parameters:

key - the key

Returns:

the attribute value

Since:

1.0

getInfoTemplate

public InfoTemplate getInfoTemplate()

Deprecated.

Returns the template.

Returns:

the info template

Since:

1.0

getAttributes

public Map<String,Object> getAttributes()

Returns all attributes of the graphic as a read-only collection.

Returns:

the attributes

Since:

1.0

getSpatialReference

public SpatialReference getSpatialReference()

Returns the spatial reference.

Returns:

the spatial reference of this graphic.

Since:

10.1.1

getDrawOrder

public int getDrawOrder()

Returns the draw order.

Returns:

the draw order of this graphic.

Since:

10.1.1

fromJson

public static Graphic fromJson(org.codehaus.jackson.JsonParser parser)
                        throws Exception

Convenient method which parses the JSON representation of a graphic into a graphic object.

Parameters:

parser - Parser initialized with a graphic JSON String.

Returns:

Graphic object.

Throws:

Exception - Exception if parsing fails.

Since:

1.0