包 com.supermap.web.clustering
类 public class SparkClusterStyle
继承 SparkClusterStyle Inheritance Style Inheritance flash.events.EventDispatcher

聚散显示发散风格类.

该类是聚散显示中聚合点显示风格的一种。SparkClusterStyle 与 SimpleClusterStyle、CellClusterStyle 的主要不同点在于：
1）当鼠标移动至聚合点上时，将动态发散显示离散点——触发 SparkClusterEvent.SPARK_OUT_START/SPARK_OUT_COMPLETE 事件；
2）当鼠标离开时，又会动态聚合离散点————触发 SparkClusterEvent.SPARK_IN_START/SPARK_IN_COMPLETE 事件；
3）可以监听离散点的点击、悬停事件，具体请参见 SparkClusterMouseEvent 类。如下图所示：

另请参见

com.supermap.web.events.SparkClusterEvent
com.supermap.web.events.SparkClusterMouseEvent

公共属性
  属性 定义方
    backgroundAlpha : Number
获取或设置 SparkClusterStyle 背景透明度，0 表示完全透明，1 表示不透明。
 SparkClusterStyle
    backgroundColor : Number
获取或设置 SparkClusterStyle 背景颜色，默认为绿色。
 SparkClusterStyle
    borderAlpha : Number
获取或设置 SparkClusterStyle 的边界透明度，0 表示完全透明，1 表示不透明。
 SparkClusterStyle
    borderColor : Number
获取或设置 SparkClusterStyle 的边界颜色，默认为黑色。
 SparkClusterStyle
    borderThickness : Number
获取或设置 SparkClusterStyle 边界宽度，单位：像素。
 SparkClusterStyle
    fieldValue : String
发散显示的权重字段，当属性 isWeightClusterStyle 为 true 时，该属性为必设.
 SparkClusterStyle
    fieldValueFun : Function
用户自定义权重计算规则。.
 SparkClusterStyle
    fieldValueMode : String
权重计算规则。默认为对聚合点内的所有离散点的权重值求和——FieldValuesRule.SUM。.
 SparkClusterStyle
    isSizeWithWeightFactor : Boolean
获取或设置 SparkClusterStyle 的大小是否随聚合点的权重大小改变。
 SparkClusterStyle
    isWeightCluster : Boolean
SparkClusterStyle
    isWeightClusterStyle : Boolean
是否根据离散点的权重定义聚合点的样式。默认为 flase.
 SparkClusterStyle
    maxCountPerRing : int
获取或设置发散显示离散点时每个发散圆上显示离散点的最大数目。
 SparkClusterStyle
    ringAngleStart : Number
获取或设置发散显示的初始始角度。
 SparkClusterStyle
    ringAngleStep : Number
获取或设置相邻离散点之间的弧度距离。
 SparkClusterStyle
    ringDistanceInc : Number
获取或设置相邻发散圆间离散点的距离。单位：像素。
 SparkClusterStyle
    ringDistanceStart : Number
获取或设置发散圆的最小半径。单位：像素。
 SparkClusterStyle
    size : Number
获取或设置 SparkClusterStyle 的大小。
 SparkClusterStyle
    sparkMaxCount : int
获取或设置发散显示离散点的个数上限.
 SparkClusterStyle
    sparkSize : Number
获取或设置发散点的大小。单位：像素。
 SparkClusterStyle
    sparkSizeOnRollOver : Number
获取或设置当鼠标移动至离散点时，离散点的显示大小。单位：像素。
 SparkClusterStyle
    textFormat : TextFormat
获取或设置 SparkClusterStyle 的文本格式。
 SparkClusterStyle
    WeightClusterItems : Array
发散显示权重子项（WeightClusterItem）集合，当属性 isWeightClusterStyle 为 true 时，该属性为必设.
 SparkClusterStyle
公共方法
  方法 定义方
   
SparkClusterStyle()
初始化 SparkClusterStyle 类的新实例。
 SparkClusterStyle
   
clear(sprite:Sprite):void
[Override] 清除显示列表构造块 Sprite.graphics 中装载的所有矢量元素。
 SparkClusterStyle
  Inherited
clone():Style
克隆 Style 对象。
 Style
   
destroy(sprite:Sprite):void
[Override] 销毁显示列表构造块 Sprite。
 SparkClusterStyle
   
draw(sprite:Sprite, geometry:Geometry, attributes:Object, map:Map):void
[Override] 绘制要素。
 SparkClusterStyle
   
initialize(sprite:Sprite, geometry:Geometry, attributes:Object, map:Map):void
[Override] 初始化 style。
 SparkClusterStyle
受保护的方法
  方法 定义方
  Inherited
dispatchEventChange():void
派发 Event.CHANGE 事件。
 Style
  Inherited
removeAllChildren(sprite:Sprite):void
清除 Sprite 中的所有子项。
 Style
  Inherited
toScreenX(map:Map, mapX:Number):Number
将地图上某一点的 X 坐标转换为屏幕坐标。
 Style
  Inherited
toScreenY(map:Map, mapY:Number):Number
将地图上某一点的 Y 坐标转换为屏幕坐标。
 Style
属性详细信息
backgroundAlpha 属性
backgroundAlpha:Number

获取或设置 SparkClusterStyle 背景透明度，0 表示完全透明，1 表示不透明。

默认值为： 1.


Implementation
    public function get backgroundAlpha():Number
    public function set backgroundAlpha(value:Number):void
backgroundColor 属性  
backgroundColor:Number

获取或设置 SparkClusterStyle 背景颜色，默认为绿色。

默认值为： 7786752.


Implementation
    public function get backgroundColor():Number
    public function set backgroundColor(value:Number):void
borderAlpha 属性  
borderAlpha:Number

获取或设置 SparkClusterStyle 的边界透明度，0 表示完全透明，1 表示不透明。

默认值为： 1.


Implementation
    public function get borderAlpha():Number
    public function set borderAlpha(value:Number):void
borderColor 属性  
borderColor:Number

获取或设置 SparkClusterStyle 的边界颜色，默认为黑色。

默认值为： 0.


Implementation
    public function get borderColor():Number
    public function set borderColor(value:Number):void
borderThickness 属性  
borderThickness:Number

获取或设置 SparkClusterStyle 边界宽度，单位：像素。

默认值为： 1.


Implementation
    public function get borderThickness():Number
    public function set borderThickness(value:Number):void
fieldValue 属性  
fieldValue:String

发散显示的权重字段，当属性 isWeightClusterStyle 为 true 时，该属性为必设.

当聚散显示样式为发散显示（SparkClusterStyle）时，聚合点的样式可根据被聚合要素的权重之和所属的范围来设置。该属性用于指定以要素的哪个字段作为权重值。


Implementation
    public function get fieldValue():String
    public function set fieldValue(value:String):void

另请参见

WeightClusterItem
WeightClusterItems
fieldValueFun 属性  
fieldValueFun:Function

用户自定义权重计算规则。.

当聚散显示样式为发散显示（SparkClusterStyle）时，聚合点的样式可根据离散点的权重按某一规则所计算的值所属的范围来设置。该规则既可使用 fieldValueMode 属性指定系统提供的规则，也可通过该属性自定义规则，如下面示例表示对各离散点的权重进行求积：
var sparkClusterStyle.fieldValueFun = newFun;
//arr 中存储各离散点权重
private function newFun(arr:Array):Number
{
var product:Number = 0;
for (var i:int;i < array.length; i++)
{
product = product*array[i];
}


Implementation
    public function get fieldValueFun():Function
    public function set fieldValueFun(value:Function):void

另请参见

FieldValuesRule
fieldValue
fieldValueMode 属性  
fieldValueMode:String

权重计算规则。默认为对聚合点内的所有离散点的权重值求和——FieldValuesRule.SUM。.

当聚散显示样式为发散显示（SparkClusterStyle）时，聚合点的样式可根据离散点的权重按某一规则所计算的值所属的范围来设置。默认规则为求和（FieldValuesRule.SUM），该规则也可由用户通过 fieldValueFun 属性自定义。离散点的权重字段由 fieldValue 设置。


Implementation
    public function get fieldValueMode():String
    public function set fieldValueMode(value:String):void

另请参见

FieldValuesRule
fieldValue
fieldValueFun
isSizeWithWeightFactor 属性  
isSizeWithWeightFactor:Boolean

获取或设置 SparkClusterStyle 的大小是否随聚合点的权重大小改变。

默认值为： true.


Implementation
    public function get isSizeWithWeightFactor():Boolean
    public function set isSizeWithWeightFactor(value:Boolean):void
isWeightCluster 属性  
isWeightCluster:Boolean


Implementation
    public function get isWeightCluster():Boolean
    public function set isWeightCluster(value:Boolean):void
isWeightClusterStyle 属性  
isWeightClusterStyle:Boolean

是否根据离散点的权重定义聚合点的样式。默认为 flase.

当聚散显示样式为发散显示（SparkClusterStyle）时，聚合点的样式可根据离散点的权重按某一规则所计算的值所属的范围来设置。默认为对离散点的权重求和。离散点的权重字段由 fieldValue 设置。
当该属性值为 true 时，表示使用 WeightClusterItems 属性来设置聚合点的样式；false 表示使用 SparkClusterStyle 类中自带的样式属性设置聚合点样式，如：backgroundAlpha、backgroundColor、borderAlpha、borderColor 等。


Implementation
    public function get isWeightClusterStyle():Boolean
    public function set isWeightClusterStyle(value:Boolean):void
maxCountPerRing 属性  
maxCountPerRing:int

获取或设置发散显示离散点时每个发散圆上显示离散点的最大数目。

默认值为： 6.


Implementation
    public function get maxCountPerRing():int
    public function set maxCountPerRing(value:int):void
ringAngleStart 属性  
ringAngleStart:Number

获取或设置发散显示的初始始角度。

默认值为： 5.


Implementation
    public function get ringAngleStart():Number
    public function set ringAngleStart(value:Number):void
ringAngleStep 属性  
ringAngleStep:Number

获取或设置相邻离散点之间的弧度距离。

默认值为： 15.


Implementation
    public function get ringAngleStep():Number
    public function set ringAngleStep(value:Number):void
ringDistanceInc 属性  
ringDistanceInc:Number

获取或设置相邻发散圆间离散点的距离。单位：像素。

默认值为： 20.


Implementation
    public function get ringDistanceInc():Number
    public function set ringDistanceInc(value:Number):void
ringDistanceStart 属性  
ringDistanceStart:Number

获取或设置发散圆的最小半径。单位：像素。

默认值为： 30.


Implementation
    public function get ringDistanceStart():Number
    public function set ringDistanceStart(value:Number):void
size 属性  
size:Number

获取或设置 SparkClusterStyle 的大小。


Implementation
    public function get size():Number
    public function set size(value:Number):void
sparkMaxCount 属性  
sparkMaxCount:int

获取或设置发散显示离散点的个数上限.

当聚合点所包含的离散点个数大于该属性值时，则不发散显示该聚合点。


Implementation
    public function get sparkMaxCount():int
    public function set sparkMaxCount(value:int):void
sparkSize 属性  
sparkSize:Number

获取或设置发散点的大小。单位：像素。

默认值为： 5.


Implementation
    public function get sparkSize():Number
    public function set sparkSize(value:Number):void
sparkSizeOnRollOver 属性  
sparkSizeOnRollOver:Number

获取或设置当鼠标移动至离散点时，离散点的显示大小。单位：像素。


Implementation
    public function get sparkSizeOnRollOver():Number
    public function set sparkSizeOnRollOver(value:Number):void
textFormat 属性  
textFormat:TextFormat

获取或设置 SparkClusterStyle 的文本格式。


Implementation
    public function get textFormat():TextFormat
    public function set textFormat(value:TextFormat):void
WeightClusterItems 属性  
WeightClusterItems:Array

发散显示权重子项（WeightClusterItem）集合，当属性 isWeightClusterStyle 为 true 时，该属性为必设.

当聚散显示样式为发散显示（SparkClusterStyle）时，聚合点的样式可根据离散点的权重之和所属的范围来设置。
该属性用于设置权重范围，以及每个权重范围所对应的聚合点样式。详情请参见 WeightClusterItem 类。


Implementation
    public function get WeightClusterItems():Array
    public function set WeightClusterItems(value:Array):void

另请参见

WeightClusterItem
构造函数详细信息
SparkClusterStyle () 构造函数
public function SparkClusterStyle()

初始化 SparkClusterStyle 类的新实例。

方法详细描述
clear () 方法
override public function clear(sprite:Sprite):void

清除显示列表构造块 Sprite.graphics 中装载的所有矢量元素。

参数

sprite:Sprite

destroy () 方法  
override public function destroy(sprite:Sprite):void

销毁显示列表构造块 Sprite。

参数

sprite:Sprite

draw () 方法  
override public function draw(sprite:Sprite, geometry:Geometry, attributes:Object, map:Map):void

绘制要素。

参数

sprite:Sprite
 
geometry:Geometry
 
attributes:Object
 
map:Map

initialize () 方法  
override public function initialize(sprite:Sprite, geometry:Geometry, attributes:Object, map:Map):void

初始化 style。

参数

sprite:Sprite — 显示列表构造块,可用于显示图形并且也可包含子项的显示列表节点。
 
geometry:Geometry — 点要素几何信息。
 
attributes:Object — 点要素属性信息。
 
map:Map — 用于装载点要素的地图。





Wed Dec 23 2015, 12:01 AM +08:00