Class: Circle

Extends

• SuperMap.Feature.Theme.RankSymbol

Members

chartBoundsSuperMap.Bounds

图表 Bounds 随着 lonlat、XOffset、YOffset 更新，注意 chartBounds 是图表像素范围，不是地理范围。

chartBoxArray.<number>

专题要素（图表）区域，即图表框，长度为 4 的一维数组，数组的 4 个元素依次表示图表框左端 x 坐标值、 下端 y坐标值、 右端 x坐标值、 上端 y 坐标值；[left, bottom, right, top]。

dataObject

用户数据，用于生成可视化 shape，可在子类中规定数据格式或类型，如：<SuperMap.Feature.Vector>。

dataValuesArray.<number>

图表展示的数据值，通过 fields 从数据 feature 属性中获得。

dataViewBoxArray.<number>

数据视图框，长度为 4 的一维数组，[left, bottom, right, top]。 dataViewBox 是统计专题要素最核心的内容，它负责解释数据在一个像素区域里的数据可视化含义， 这种含义用可视化图形表达出来，这些表示数据的图形和一些辅助图形组合在一起构成统计专题图表。

DVBCenterPointArray.<number>

数据视图框中心点，长度为 2 的一维数组，第一个元素表示 x 坐标，第二个元素表示 y 坐标。

DVBCodomainArray.<number>

数据视图框的内允许展示的数据值域，长度为 2 的一维数组，第一个元素表示值域下限，第二个元素表示值域上限。 dataViewBox 中允许的数据范围，对数据溢出值域范围情况的处理需要在 assembleShapes 中进行。

DVBHeightnumber

数据视图框高度。

DVBOrigonPointArray.<number>

数据视图框原点，数据视图框左上角点，长度为 2 的一维数组，第一个元素表示 x 坐标，第二个元素表示 y 坐标。

DVBParameterArray.<number>

数据视图框参数，长度为 4 的一维数组（数组元素值 >= 0），[leftOffset, bottomOffset, rightOffset, topOffset]，chartBox 内偏距值。 此属性用于指定数据视图框 dataViewBox 的范围。

DVBUnitValuestring

单位值。在 assembleShapes() 中初始化其具体意义，例如：饼图的 DVBUnitValue 可以定义为"360/数据总和"， 折线图的 DVBUnitValue 可以定义为 "DVBCodomain/DVBHeight"。

DVBWidthnumber

数据视图框宽度。

fieldsArray.<string>

数据{SuperMap.Feature.Vector}属性字段。

heightnumber

专题要素（图表）高度 。

idstring

专题要素唯一标识。

layerSuperMap.Layer.Theme

此专题要素所在专题图层。

locationArray

专题要素像素参考位置。通常由地理参考位置决定。长度为 2 的数组，第一个元素表示 x 坐标，第二个元素表示 y 坐标。

lonlatSuperMap.LonLat

专题要素地理参考位置。子类中必须根据用户数据（或地理位置参数）对其赋值。

origonPointArray.<number>

专题要素（图表）原点，图表左上角点像素坐标，是长度为 2 的一维数组，第一个元素表示 x 坐标，第二个元素表示 y 坐标。

origonPointOffsetArray.<number>

数据视图框原点相对于图表框的原点偏移量，长度为 2 的一维数组，第一个元素表示 x 偏移量，第二个元素表示 y 偏移量。

RelativeCoordinateboolean

图形是否已经计算了相对坐标。

settingObject

符号配置对象，该对象控制着图表的可视化显示。 下面是此配置对象的 5 个基础可设属性：

shapeFactorySuperMap.Feature.ShapeFactory

内置的图形工厂对象，调用其 createShape 方法创建图形。

shapeParametersObject

当前图形参数对象，<SuperMap.Feature.ShapeParameters> 的子类对象。

shapesArray

构成此专题要素的可视化图形对象数组，数组顺序控制渲染。

widthnumber

专题要素（图表）宽度 。

XOffsetnumber

专题要素（图表）在 X 方向上的偏移值，单位像素。

YOffsetnumber

专题要素（图表）在 Y 方向上的偏移值，单位像素。

Methods

assembleShapes()

common/overlay/Circle.js, line 36

装配图形（扩展接口）。

inherited constructor(data, layer){SuperMap.Feature.Theme}

common/overlay/feature/Theme.js, line 17

构造函数。

Name	Type	Description
data	Object	用户数据，用于生成可视化 shape，必设参数。
layer	SuperMap.Layer.Theme	此专题要素所在图层，必设参数。

Returns:

Type	Description
SuperMap.Feature.Theme	返回一个专题要素。

inherited destroy()

common/overlay/Circle.js, line 28

销毁专题要素。

inherited getLocalXY(lonlat)

common/overlay/Graph.js, line 469

地理坐标转为像素坐标。

Name	Type	Description
lonlat	SuperMap.Lonlat	带转换的地理坐标。

Returns:

屏幕像素坐标。

inherited initBaseParameter(codomain, XOffset, YOffset, dataViewBoxParameter, decimalNumber){boolean}

common/overlay/RankSymbol.js, line 59

初始化专题要素（图形）基础参数。 在调用此方法前，此类的图表模型相关属性都是不可用的 ，此方法在 assembleShapes 函数中调用。 调用此函数关系到 setting 对象的以下属性。

Name	Type	Description
codomain	Array.<number>	值域，长度为 2 的一维数组，第一个元素表示值域下限，第二个元素表示值域上限。
XOffset	number	可选 专题要素（图形）在 X 方向上的偏移值，单位像素。
YOffset	number	可选 专题要素（图形）在 Y 方向上的偏移值，单位像素。
dataViewBoxParameter	Array.<number>	可选 数据视图框 dataViewBox 参数，它是指图形框 chartBox （由图表位置、图表宽度、图表高度构成的图表范围框）在左、下，右，上四个方向上的内偏距值。
decimalNumber	number	可选 数据值数组 dataValues 元素值小数位数，数据的小数位处理参数，取值范围：[0, 16]。如果不设置此参数，在取数据值时不对数据做小数位处理。

Returns:

Type	Description
boolean	初始化参数是否成功。

inherited resetLinearGradient()

common/overlay/Graph.js, line 373

resetLocation 中调用 图表的相对坐标存在的时候，重新计算渐变的颜色（目前用于二维柱状图渐变色 所以子类实现此方法）。

inherited resetLocation(lonlat){Array.<number>}

common/overlay/Graph.js, line 342

根据地理位置 lonlat 重置专题要素（图表）位置。

Name	Type	Description
lonlat	SuperMap.LonLat	专题要素新的像素中心位置。

Returns:

Type	Description
Array.<number>	新专题要素像素参考位置。长度为 2 的数组，第一个元素表示 x 坐标，第二个元素表示 y 坐标。

inherited shapesConvertToRelativeCoordinate()

common/overlay/Graph.js, line 381

将（构成图表）图形的节点转为相对坐标表示，此函数必须且只能在 assembleShapes() 结束时调用。

Type Definitions

SuperMap.Feature.Theme.Circle.settingObject

Properties:

Name	Type	Default	Description
codomain	Array.<number>		图表允许展示的数据值域，长度为 2 的一维数组，第一个元素表示值域下限，第二个元素表示值域上限。
maxR	number		可选 圆形的最大半径。
minR	number		可选 圆形的最小半径。
fillColor	string		可选 圆形的填充色，如：fillColor: "#FFB980"。
circleStyle	Object		可选 圆形的基础 style，此参数控制圆形基础样式，优先级低于 circleStyleByFields 和 circleStyleByCodomain。
decimalNumber	number		可选 数据值数组 dataValues 元素值小数位数，数据的小数位处理参数，取值范围：[0, 16]。如果不设置此参数，在取数据值时不对数据做小数位处理。
circleHoverStyle	Object		可选 圆形 hover 状态时的样式，circleHoverAble 为 true 时有效。
circleHoverAble	boolean	true	可选 是否允许圆形使用 hover 状态。同时设置 circleHoverAble 和 circleClickAble 为 false，可以直接屏蔽图形对专题图层事件的响应。
circleClickAble	boolean	true	可选 是否允许圆形被点击。同时设置 circleHoverAble 和 circleClickAble 为 false，可以直接屏蔽图形对专题图层事件的响应。