Packagecom.esri.bacore.thematicmapping
Classpublic class TMSymbolizationProvider
InheritanceTMSymbolizationProvider Inheritance flash.events.EventDispatcher
Subclasses TMClassificationProvider

The TMSymbolizationProvider class is the base symbolization provider of thematic layer. This class provides a simple symbolization of thematic layer with the unique-value renderer. Derived classes provide more complex symbolization of thematic layer.



Public Properties
 PropertyDefined By
  classificationIsLocked : Boolean
[read-only] Indicates that a classification provided with this instance is locked and cannot be updated right now.
TMSymbolizationProvider
  createSymbolFactory : Function
A factory method to be used for creating a symbol by color.
TMSymbolizationProvider
  layer : TMLayer
[read-only] Thematic layer associated with this component.
TMSymbolizationProvider
  simpleRendererLabel : String
This label is assigned to a simple renderer created with createSimpleRenderer method.
TMSymbolizationProvider
Public Methods
 MethodDefined By
  
Initializes a new instance of the TMSymbolizationProvider class.
TMSymbolizationProvider
  
createRenderer():Renderer
Creates a renderer for the current classification.
TMSymbolizationProvider
  
Unlocks the classification provided with this instance without raising events.
TMSymbolizationProvider
  
setLayer(layer:TMLayer):void
TMSymbolizationProvider
  
Unlocks the classification provided with this instance and raises the CLASSIFICATION_CHANGED event if the classification lock state was changed from locked to unlocked.
TMSymbolizationProvider
  
updateClassification(data:Array):Boolean
Updates classification provided with this instance by an array of thematic values.
TMSymbolizationProvider
Protected Methods
 MethodDefined By
  
Creates a simple renderer whose symbol is the mid value of the current color ramp of the associated thematic layer and label is the simpleRendererLabel property value.
TMSymbolizationProvider
  
createSymbol(color:uint, index:int):Symbol
Create a symbol by the given color.
TMSymbolizationProvider
  
Deprecated Since Community Analyst API for Flex 2.2: Please Use createSimpleRenderer()
Creates unique-value renderer whose default symbol is the mid value of the current color ramp of the associated thematic layer.
TMSymbolizationProvider
  
Dispatches the CLASSIFICATION_CHANGED event.
TMSymbolizationProvider
  
This method is invoked when thematic layer is changed.
TMSymbolizationProvider
Events
 Event Summary Defined By
  The propertyChange event is dispatched when a property of the symbolization provider is changed.TMSymbolizationProvider
Public Constants
 ConstantDefined By
  CLASSIFICATION_CHANGED : String = classificationChanged
[static] The TMSymbolizationProvider.CLASSIFICATION_CHANGED constant defines the value of the type property of the flash.events.Event object for a classificationChanged event.
TMSymbolizationProvider
Property Detail
classificationIsLockedproperty
classificationIsLocked:Boolean  [read-only]

Indicates that a classification provided with this instance is locked and cannot be updated right now.

The base symbolization provider has a simple classification consisting of one class and this property value is always true for it. This property should be overriden in derived classes to provide a thematic classification of features.


Implementation
    public function get classificationIsLocked():Boolean
createSymbolFactoryproperty 
createSymbolFactory:Function

A factory method to be used for creating a symbol by color.

The signature of this method is the following:

createSymbolFactory(layer:TMLayer, color:uint, index:int):Symbol;

The index parameter passed to this factory specifies a zero-based index of color in the color ramp. Two special values of indices are also possible: -1 means that a symbol for the mid color of the color ramp is requested (this case is used with the UniqueValueRenderer when classification ranges are missing) and -2 means that out-of-range symbol is requested.


Implementation
    public function get createSymbolFactory():Function
    public function set createSymbolFactory(value:Function):void
layerproperty 
layer:TMLayer  [read-only]

Thematic layer associated with this component.


Implementation
    public function get layer():TMLayer
simpleRendererLabelproperty 
simpleRendererLabel:String

Since : Community Analyst API for Flex 2.2.

This label is assigned to a simple renderer created with createSimpleRenderer method.


Implementation
    public function get simpleRendererLabel():String
    public function set simpleRendererLabel(value:String):void
Constructor Detail
TMSymbolizationProvider()Constructor
public function TMSymbolizationProvider()

Initializes a new instance of the TMSymbolizationProvider class.

Method Detail
createRenderer()method
public function createRenderer():Renderer

Creates a renderer for the current classification.

A thematic layer should be associated with this instance to allow using this method. The base implementation returns a unique-value renderer.

Returns
Renderer — A new renderer.
createSimpleRenderer()method 
protected function createSimpleRenderer():Renderer

Since : Community Analyst API for Flex 2.2.

Creates a simple renderer whose symbol is the mid value of the current color ramp of the associated thematic layer and label is the simpleRendererLabel property value.

Returns
Renderer — A new renderer.
createSymbol()method 
protected function createSymbol(color:uint, index:int):Symbol

Create a symbol by the given color.

This factory-method creates symbols which will be used in a renderer of thematic layer. See createSymbolFactory property for details.

If the createSymbolFactory property is null, a simple fill symbol with solid fill color is created and border is got from the layer's borderSymbol property.

Parameters

color:uint — RGB color to create symbol for.
 
index:int — Index of color in the color ramp.

Returns
Symbol — A new symbol.
createUniqueValueRenderer()method 
protected function createUniqueValueRenderer():Renderer
Deprecated Since Community Analyst API for Flex 2.2: Please Use createSimpleRenderer()

Creates unique-value renderer whose default symbol is the mid value of the current color ramp of the associated thematic layer.

Returns
Renderer — A new renderer.
doUnlockClassification()method 
public function doUnlockClassification():Boolean

Unlocks the classification provided with this instance without raising events.

The base version of this method does nothing and returns the false value.

Returns
Boolean — True if the classification lock state was changed from locked to unlocked.
onClassificationChanged()method 
protected function onClassificationChanged():void

Dispatches the CLASSIFICATION_CHANGED event.

onLayerChanged()method 
protected function onLayerChanged():void

This method is invoked when thematic layer is changed.

The base version of this method does nothing.

setLayer()method 
public function setLayer(layer:TMLayer):void

Parameters

layer:TMLayer

unlockClassification()method 
public function unlockClassification():void

Unlocks the classification provided with this instance and raises the CLASSIFICATION_CHANGED event if the classification lock state was changed from locked to unlocked.

updateClassification()method 
public function updateClassification(data:Array):Boolean

Updates classification provided with this instance by an array of thematic values.

The data array should contain numerical values. Null value of data parameter means that the thematic value for features doesn't calculated. The base implementation of this method returns false.

Parameters

data:Array — Input data.

Returns
Boolean — True if the classification was updated.
Event Detail
propertyChange Event
Event Object Type: mx.events.PropertyChangeEvent
PropertyChangeEvent.type property = mx.events.PropertyChangeEvent.PROPERTY_CHANGE

The propertyChange event is dispatched when a property of the symbolization provider is changed.

Constant Detail
CLASSIFICATION_CHANGEDConstant
public static const CLASSIFICATION_CHANGED:String = classificationChanged

The TMSymbolizationProvider.CLASSIFICATION_CHANGED constant defines the value of the type property of the flash.events.Event object for a classificationChanged event.