ArcGIS Runtime SDK for iOS
100.15
|
A renderer based on unique values.
A unique value renderer symbolizes groups of graphics or features that have matching attributes with the same symbol. This is most common with nominal, or string data. Different groups use different symbols.
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, graphics and 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.
Instance Methods | |
(instancetype) | - initWithFieldNames:uniqueValues:defaultLabel:defaultSymbol: |
(BOOL) | - isEqualToRenderer: |
(AGSSymbol *) | - symbolForFeature: |
(AGSSymbol *) | - symbolForFeature:applyAttributeOverrides: |
(AGSSymbol *) | - symbolForGraphic: |
(AGSSymbol *) | - symbolForGraphic:applyAttributeOverrides: |
(nullable id) | - toJSON: |
Class Methods | |
(nullable id< AGSJSONSerializable >) | + fromJSON:error: |
(instancetype) | + uniqueValueRenderer |
(instancetype) | + uniqueValueRendererWithFieldNames:uniqueValues:defaultLabel:defaultSymbol: |
Properties | |
NSString * | defaultLabel |
AGSSymbol * | defaultSymbol |
NSArray< NSString * > * | fieldNames |
NSString * | rotationExpression |
AGSRotationType | rotationType |
AGSRendererSceneProperties * | sceneProperties |
NSArray< AGSUniqueValue * > * | uniqueValues |
NSDictionary< NSString *, id > * | unknownJSON |
NSDictionary< NSString *, id > * | unsupportedJSON |
|
staticrequiredinherited |
Initializes and returns an object from its JSON representation.
JSONObject | NSDictionary or NSArray containing the JSON. |
error | encountered during the operation, if any. |
- (instancetype) initWithFieldNames: | (nullable NSArray< NSString * > *) | fieldNames | |
uniqueValues: | (nullable NSArray< AGSUniqueValue * > *) | uniqueValues | |
defaultLabel: | (NSString *) | defaultLabel | |
defaultSymbol: | (nullable AGSSymbol *) | defaultSymbol | |
Initialize a unique value renderer with the given properties.
fieldNames | An array of strings with field names representing attributes of a graphic or feature that the renderer uses to match values against. |
uniqueValues | An array of AGSUniqueValue objects defining the symbol for each matched value |
defaultLabel | for the renderer |
defaultSymbol | used for any unmatched values |
- (BOOL) isEqualToRenderer: | (AGSRenderer *) | other |
Compares two renderers for equality.
other | renderer to compare this one to. |
YES
if other
is equal to self
, otherwise NO
. - (AGSSymbol*) symbolForFeature: | (AGSFeature *) | feature |
Creates a symbol for the feature based on the scheme used by this renderer.
feature | The feature to determine the symbol for. |
feature
. - (AGSSymbol*) symbolForFeature: | (AGSFeature *) | feature | |
applyAttributeOverrides: | (BOOL) | applyAttributeOverrides | |
Creates a symbol for the feature based on the scheme used by this renderer and optionally apply attribute overrides.
If applyAttributeOverrides
is set to YES
and renderer contains an override expression, this method will return a symbol modified by the expression. If the expression cannot be properly evaluated due to missing fields or external data, then the original symbol is returned.
feature | The feature to determine the symbol for. |
applyAttributeOverrides | If set YES , applies the override attributes from the renderer. |
feature
. - (AGSSymbol*) symbolForGraphic: | (AGSGraphic *) | graphic |
Creates a symbol for the graphic based on the scheme used by this renderer.
graphic | The graphic to determine the symbol for. |
graphic
. - (AGSSymbol*) symbolForGraphic: | (AGSGraphic *) | graphic | |
applyAttributeOverrides: | (BOOL) | applyAttributeOverrides | |
Creates a symbol for the graphic based on the scheme used by this renderer and optionally apply attribute overrides.
graphic | The graphic to determine the symbol for. |
applyAttributeOverrides | If set YES , applies the override attributes from the renderer. |
graphic
.
|
requiredinherited |
Returns JSON representation for this object.
error | encountered during the operation, if any. |
NSDictionary
or NSArray
containing the JSON. Reimplemented in AGSPortalItem.
+ (instancetype) uniqueValueRenderer |
Initialize a unique value renderer.
+ (instancetype) uniqueValueRendererWithFieldNames: | (nullable NSArray< NSString * > *) | fieldNames | |
uniqueValues: | (nullable NSArray< AGSUniqueValue * > *) | uniqueValues | |
defaultLabel: | (NSString *) | defaultLabel | |
defaultSymbol: | (nullable AGSSymbol *) | defaultSymbol | |
Initialize a unique value renderer with the given properties
fieldNames | An array of strings with field names representing attributes of a graphic or feature that the renderer uses to match values against. |
uniqueValues | An array of AGSUniqueValue objects defining the symbol for each matched value |
defaultLabel | for the renderer |
defaultSymbol | used for any unmatched values |
|
readwritenonatomiccopy |
Default label for the renderer
|
readwritenonatomicstrong |
Default symbol for the renderer. This symbol is used for any unmatched values.
|
readwritenonatomiccopy |
A list of strings with field names. The names represent attributes of a graphic or feature that the renderer uses to match values against.
|
readwritenonatomiccopyinherited |
Constant value or an expression that specifies the angle of rotation based on a feature's attribute value. When an attribute name is specified in rotationExpression, it's enclosed in square brackets, for example, [Rotation].
|
readwritenonatomicassigninherited |
Controls the origin and direction of rotation. If the rotationType
is defined as AGSRotationTypeTypeArithmetic
, the symbol is rotated from East in a counter-clockwise direction where East is the 0° axis. If the rotationType is defined as AGSRotationTypeGeographic
, the symbol is rotated from North in a clockwise direction where North is the 0° axis.
|
readwritenonatomicstronginherited |
Properties to apply only when rendering data in 3D scenes using AGSSceneView
.
|
readwritenonatomiccopy |
An array of AGSUniqueValue
objects defining the symbol for each matched value
|
readrequirednonatomiccopyinherited |
A dictionary of values that was in the source JSON but was unparsed by API.
NSDictionary
containing the unknown JSON.
|
readnonatomiccopyinherited |
A dictionary of values that are supported by the REST API, but not exposed through the SDK API.
NSDictionary
containing the unsupported JSON.