AGSUniqueValueRenderer Class Reference


Description

A unique value renderer symbolizes groups of graphics that have matching attributes. This is most common with nominal, or string data.

For example, you could use a unique value renderer to symbolize zoning designations: yellow for "Residential", purple for "Industrial", red for "Commercial", and so on. You can also use unique value renderers on numeric fields that are coded values, or on ordinal attributes such as "First", "Second", "Third", and so on.

Typically features are rendered based on the unique values of one attribute field. However, up to three fields can be combined to generate a unique value.

Defined in:
AGSUniqueValueRenderer.h ( ArcGIS library)
Since:
1.0
Inheritance diagram for AGSUniqueValueRenderer:
AGSRenderer <AGSCoding>

List of all members.

Public Member Functions

(void) - decodeWithJSON:
(NSDictionary *) - encodeToJSON
(id) - initWithJSON:
(UIImage *) - swatchForGraphic:geometryType:size:
(UIImage *) - swatchForGraphic:size:
(AGSSymbol *) - symbolForGraphic:
(AGSSymbol *) - symbolForGraphic:timeExtent:

Properties

NSString * defaultLabel
AGSSymboldefaultSymbol
NSString * field1
NSString * field2
NSString * field3
NSString * fieldDelimiter
NSMutableArray * uniqueValues

Member Function Documentation

- (void) decodeWithJSON: (NSDictionary *)  json   [optional, inherited]

Decode object from JSON representation.

Parameters:
json The JSON representation of the object to be decoded.
Since:
1.0
- (NSDictionary *) encodeToJSON   [optional, inherited]

Encode and return JSON representation for object.

Returns:
JSON representation of object.
Since:
1.0
- (id) initWithJSON: (NSDictionary *)  json   [optional, inherited]

Initialize and return object from JSON representation.

Parameters:
json The JSON representation of the object to be created.
Returns:
Object decoded from JSON representation.
Since:
1.0
- (UIImage *) swatchForGraphic: (AGSGraphic *)  graphic
geometryType: (AGSGeometryType geometryType
size: (CGSize)  size 

Returns an image that represents a swatch for a particular graphic. This method can be used when your graphic does not have a geometry but you know the geometry type.

Parameters:
graphic Graphic for which the swatch should be drawn. This is used to determine what symbol in the renderer is used.
geometryType The type of the geometry determines what kind of swatch is drawn.
size Size of the output swatch.
Returns:
UIImage of the drawn swatch.
- (UIImage *) swatchForGraphic: (AGSGraphic *)  graphic
size: (CGSize)  size 

Returns an image that represents a swatch for a particular graphic. The graphic must have a valid geometry.

Parameters:
graphic Graphic for which the swatch should be drawn. This is used to determine what symbol in the renderer is used.
size Size of the output swatch.
Returns:
UIImage of the drawn swatch.
- (AGSSymbol *) symbolForGraphic:  

Return a symbol for the graphic based on the scheme used by this renderer.

Parameters:
graphic The graphic to determine symbol.
Returns:
Symbol for graphic.
Since:
1.0
Deprecated:
Deprecated at 1.8. Use symbolForGraphic:timeExtent: instead.
- (AGSSymbol *) symbolForGraphic: (AGSGraphic *)  graphic
timeExtent: (AGSTimeExtent *)  timeExtent 

Return a symbol for the graphic based on the scheme used by this renderer.

Parameters:
graphic The graphic to determine symbol.
timeExtent The time extent to determine the symbol at.
Returns:
Symbol for graphic.
Since:
1.8

Property Documentation

- (NSString*) defaultLabel [read, write, retain]

Label for the default symbol used to draw unspecified values.

Since:
1.0
- (AGSSymbol*) defaultSymbol [read, write, retain]

Default symbol for the renderer. This symbol is used for any unmatched values.

Since:
1.0
- (NSString*) field1 [read, write, retain]

The name of the attribute field the renderer uses to match values against.

Since:
1.0
- (NSString*) field2 [read, write, retain]

If needed , specifies an additional attribute field the renderer uses to match values.

Since:
1.0
- (NSString*) field3 [read, write, retain]

If needed , specifies an additional attribute field the renderer uses to match values.

Since:
1.0
- (NSString*) fieldDelimiter [read, write, retain]

String inserted between the values if multiple attribute fields are specified.

Since:
1.0
- (NSMutableArray*) uniqueValues [read, retain]

An array of AGSUniqueValue objects defined for the renderer.

Since:
1.0