Class: ThemeGraph

Extends

• SuperMap.Theme

Members

barWidthnumber

柱状专题图中每一个柱的宽度。使用地图坐标单位，默认值为0。
只有选择的统计图类型为柱状图（柱状图、三维柱状图、堆叠柱状图、三维堆叠柱状图）时，此项才可设置。

flowSuperMap.ThemeFlow

统计专题图流动显示与牵引线设置。 通过该字段可以设置统计符号是否流动显示和牵引线风格。

graduatedModeSuperMap.GraduatedMode

统计图中地理要素的值与图表尺寸间的映射关系（常数、对数、平方根），即分级方式。 默认值为 SuperMap.GraduatedMode.CONSTANT。 分级主要是为了减少制作统计专题图中数据大小之间的差异，使得统计图的视觉效果比较好，同时不同类别之间的比较也还是有意义的。 提供三种分级模式：常数、对数和平方根，对于有值为负数的字段，不可以采用对数和平方根的分级方式。不同的等级方式用于确定符号大小的数值是不相同的。

graphAxesSuperMap.ThemeGraphAxes

用于设置统计图中坐标轴样式相关信息，如坐标轴颜色、是否显示、坐标文本样式等。

graphAxesTextDisplayModeSuperMap.GraphAxesTextDisplayMode

统计专题图坐标轴文本显示模式 。默认值 SuperMap.GraphAxesTextDisplayMode.NONE。

graphSizeSuperMap.ThemeGraphSize

用于设置统计符号的最大最小尺寸。

graphSizeFixedboolean

缩放地图时统计图符号是否固定大小。默认值为 false，即统计图符号将随地图缩放。

graphTextSuperMap.ThemeGraphText

统计图上的文字是否可以见以及文字标注风格。

graphTypeSuperMap.ThemeGraphType

统计专题图类型。SuperMap 提供了多种类型的统计图，
分别为面积图、阶梯图、折线图、点状图、柱状图、三维柱状图、饼图、三维饼图、玫瑰图、三维玫瑰图、堆叠柱状图、三维堆叠柱状图、环状图。默认为面积图。

itemsArray.<SuperMap.ThemeGraphItem>

统计专题图子项集合。必设字段。 统计专题图可以基于多个变量，反映多种属性，即可以将多个专题变量的值绘制在一个统计图上。每一个专题变量对应的统计图即为一个专题图子项。 对于每个专题图子项可以为其设置标题、风格，甚至可以将该子项再制作成范围分段专题图。

memoryDataSuperMap.ThemeMemoryData

专题图内存数据。
用内存数据制作专题图的方式与表达式制作专题图的方式互斥，前者优先级较高。 第一个参数代表专题值，即数据集中用来做专题图的字段或表达式的值；第二个参数代表外部值。在制作专题图时，会用外部值代替专题值来制作相应的专题图。

memoryKeysArray.<integer>

以内存数组方式制作专题图时的键数组。
键数组内的数值代表 SmID 值，它与 SuperMap.ThemeGraphItem 类中的值数组（SuperMap.ThemeGraphItem.memoryDoubleValues）要关联起来应用。
键数组中数值的个数必须要与值数组的数值个数一致。值数组中的值将代替原来的专题值来制作统计专题图。
目前所有的专题图都支持以内存数组的方式制作专题图，但统计专题图与其他专题图指定内存数组的方式不同，
统计专题图使用 memoryKeys 指定内存数组，而其他专题图则使用 memoryData 来指定内存数组。

Example

memoryKeys的使用方法如：
  function addThemeGraph() {
     removeTheme();
       //创建统计专题图对象，SuperMap.ThemeGraph 必设 items。
      //专题图参数 ThemeParameters 必设 theme（即以设置好的分段专题图对象）、dataSourceName 和 datasetName
     var style1 = new SuperMap.ServerStyle({
                  fillForeColor: new SuperMap.ServerColor(92,73,234),
                  lineWidth: 0.1
              }),
              style2 = new SuperMap.ServerStyle({
                  fillForeColor: new SuperMap.ServerColor(211,111,240),
                  lineWidth: 0.1
              }),
              item1 = new SuperMap.ThemeGraphItem({
                  memoryDoubleValues:[1.18,0.95,0.37,1.31,0.8,1.5],
                 caption: "1992-1995人口增长率",
                 graphExpression: "Pop_Rate95",
                  uniformStyle: style1
              }),
              item2 = new SuperMap.ThemeGraphItem({
              //以内存数组方式制作专题图时的值数组
                  memoryDoubleValues:[2.71,0,0.74,3.1,2.2,3.5],
                  caption: "1995-1999人口增长率",  //专题图子项的名称
                  graphExpression: "Pop_Rate99",  //统计专题图的专题变量
                  uniformStyle: style2      //统计专题图子项的显示风格
              }),
              themeGraph  = new SuperMap.ThemeGraph({
              //以内存数组方式制作专题图时的键数组，键数组内的数值代表 SmID 值
                   memoryKeys:[1,2,4,8,10,12],
                  items: new Array(item1,item2),
                  barWidth: 0.03,
                   //统计图中地理要素的值与图表尺寸间的映射关系为平方根
                  graduatedMode: SuperMap.GraduatedMode.SQUAREROOT,
                  //graphAxes用于设置统计图中坐标轴样式相关信息
                  graphAxes: new SuperMap.ThemeGraphAxes({
                      axesDisplayed: true
                  }),
                  graphSize: new SuperMap.ThemeGraphSize({
                      maxGraphSize: 1,
                      minGraphSize: 0.35
                  }),
                  //统计图上的文字是否可以见以及文字标注风格
                  graphText: new SuperMap.ThemeGraphText({
                      graphTextDisplayed: true,
                      graphTextFormat: SuperMap.ThemeGraphTextFormat.VALUE,
                      graphTextStyle: new SuperMap.ServerTextStyle({
                          sizeFixed: true,
                          fontHeight: 9,
                          fontWidth: 5
                      })
                  }),
                  //统计专题图类型为三维柱状图
                  graphType: SuperMap.ThemeGraphType.BAR3D
              }),
//专题图参数对象
              themeParameters = new SuperMap.ThemeParameters({
                  themes: [themeGraph],
                  dataSourceNames: ["Jingjin"],
                  datasetNames: ["BaseMap_R"]
              }),
   //与服务端交互
              themeService=new SuperMap.ThemeService(url, {
                  eventListeners: {
                      "processCompleted": ThemeCompleted,
                       "processFailed": themeFailed
                 }
             });
      themeService.processAsync(themeParameters);
  }

negativeDisplayedboolean

专题图中是否显示属性为负值的数据。true 表示显示；默认为 false 即不显示。

offsetSuperMap.ThemeOffset

用于设置统计图相对于要素内点的偏移量。

overlapAvoidedboolean

统计图是否采用避让方式显示。
1.对数据集制作统计专题图:当统计图采用避让方式显示时，如果 overlapAvoided 为 true，则在统计图重叠度很大的情况下， 会出现无法完全避免统计图重叠的现象；如果 overlapAvoided 为 false，会过滤掉一些统计图，从而保证所有的统计图均不重叠。
2.对数据集同时制作统计专题图和标签专题图：当统计图不显示子项文本时，标签专题图的标签即使和统计图重叠，两者也都可正常显示； 当统计图显示子项文本时，如果统计图中的子项文本和标签专题图中的标签不重叠，则两者均正常显示；如果重叠，则会过滤掉统计图的子项文本，只显示标签。

roseAnglenumber

统计图中玫瑰图或三维玫瑰图用于等分的角度，默认为0度，精确到0.1度。在角度为0或者大于360度的情况下均使用360度来等分制作统计图的字段数。

startAnglenumber

饼状统计图扇形的起始角度。默认为0度，精确到0.1度，以水平方向为正向。只有选择的统计图类型为饼状图（饼图、三维饼图、玫瑰图、三维玫瑰图）时，此项才可设置。

typestring

专题图类型。

Methods

staticSuperMap.ThemeGraph.fromObj(obj){SuperMap.ThemeGraph}

common/iServer/ThemeGraph.js, line 334

从传入对象获取统计专题图类。

Name	Type	Description
obj	Object	传入对象

Returns:

Type	Description
SuperMap.ThemeGraph	ThemeGraph对象

inherited destroy()

common/iServer/Theme.js, line 37

释放资源，将引用资源的属性置空。

toJSON(){string}

common/iServer/ThemeGraph.js, line 277

将SuperMap.ThemeGraph对象转化为json字符串。

Returns:

Type	Description
string	返回转换后的 JSON 字符串。

toServerJSONObject(){Object}

common/iServer/ThemeGraph.js, line 286

转换成对应的 JSON 格式对象。

Returns:

Type	Description
Object	对应的 JSON 格式对象。