com.supermap.mapping
类 ThemeGraph

java.lang.Object
  com.supermap.mapping.Theme
      com.supermap.mapping.ThemeGraph

public class ThemeGraph
extends Theme

统计专题图类。

统计专题图通过为每个要素或记录绘制统计图来反映其对应的专题值的大小。统计专题图可以基于多个变量，反映多种属性，即可以将多个专题变量的值绘制在一个统计图上。

目前提供的统计图类型有：面积图、阶梯图、折线图、点状图、柱状图、三维柱状图、饼图、三维饼图、玫瑰图、三维玫瑰图、面状金字塔图、堆叠柱状图、三维堆叠柱状图、环状图。 注：用来制作专题图的数据称为专题变量。

构造方法摘要

ThemeGraph()
默认构造函数，构造一个新的 ThemeGraph 对象。

ThemeGraph(ThemeGraph themeGraph)
拷贝构造函数，根据给定的 ThemeGraph 对象构造一个与其完全相同的新对象。

方法摘要

int	add(ThemeGraphItem item) 添加统计专题图的子项到专题图子项列表中。
void	clear() 删除统计专题图中的所有子项。
void	dispose() 释放对象所占用的资源。
boolean	exchangeItem(int index1, int index2) 将指定序号的两个子项进行位置交换。
java.awt.Color	getAxesColor() 返回坐标轴颜色。
GraphAxesTextDisplayMode	getAxesTextDisplayMode() 返回显示坐标轴文本时，显示的文本模式，
TextStyle	getAxesTextStyle() 返回统计图坐标轴文本的风格。
double	getBarSpaceRatio() 返回柱状专题图中柱体的间隔，返回值为一个系数值，数值范围为0到10，默认值为1。
double	getBarWidth() 已过时。
double	getBarWidthRatio() 返回柱状专题图中每一个柱的宽度，返回值为一个系数值，数值范围为0到10，默认值为1。
int	getCount() 返回统计专题图子项的个数。
java.lang.String	getCustomGraphSizeExpression() 返回一个字段表达式，该字段表达式用于控制对象对应的统计专题图元素的大小，字段表达式中的字段必须为数值型字段。
GraduatedMode	getGraduatedMode() 返回专题图分级模式。
ThemeGraphTextFormat	getGraphTextFormat() 返回统计专题图文本显示格式，如百分数、真实数值、标题、标题+百分数、标题+真实数值。
TextStyle	getGraphTextStyle() 返回统计图上的文字标注风格。
ThemeGraphType	getGraphType() 返回统计专题图的统计图类型。
ThemeGraphItem	getItem(int index) 返回指定序号的统计专题图子项。
GeoStyle	getLeaderLineStyle() 返回统计图与其表示对象之间牵引线的风格。
double	getMaxGraphSize() 返回统计专题图中统计符号显示的最大值。
int[]	getMemoryKeys() 返回以内存数组方式制作专题图时的键数组。
double	getMinGraphSize() 返回统计专题图中统计符号显示的最小值。
java.lang.String	getOffsetX() 返回统计图的水平偏移量。
java.lang.String	getOffsetY() 返回统计图的垂直偏移量。
double	getRoseAngle() 返回统计图中玫瑰图或三维玫瑰图分片的角度。
double	getStartAngle() 返回饼状统计图的起始角度，默认以水平方向为正向。
int	indexOf(java.lang.String graphExpression) 返回统计专题图中指定统计字段表达式的对象在当前统计图子项序列中的序号。
boolean	insert(int index, ThemeGraphItem item) 将给定的统计专题图子项插入到指定序号的位置。
boolean	isAllDirectionsOverlappedAvoided() 设置是否允许以全方向统计专题图避让。
boolean	isAxesDisplayed() 返回是否显示坐标轴。
boolean	isAxesGridDisplayed() 返回是否在统计图坐标轴上显示网格。
boolean	isAxesTextDisplayed() 返回是否显示坐标轴的文本标注。
boolean	isFlowEnabled() 返回统计专题图是否流动显示。
boolean	isGlobalMaxValueEnabled() 返回是否使用全局最大值制作统计专题图。
boolean	isGraphSizeFixed() 返回在放大或者缩小地图时统计图是否固定大小。
boolean	isGraphTextDisplayed() 返回是否显示统计图上的文本标注。
boolean	isLeaderLineDisplayed() 返回是否显示统计图和它所表示的对象之间的牵引线。
boolean	isNegativeDisplayed() 返回专题图中是否显示属性为负值的数据。
boolean	isOffsetFixed() 返回统计图是否固定偏移量。
boolean	isOverlapAvoided() 返回统计图是否采用避让方式显示。
boolean	remove(int index) 在统计专题图子项序列中删除指定序号的统计专题图子项。
void	setAllDirectionsOverlappedAvoided(boolean value) 设置是否允许以全方向统计专题图避让。
void	setAxesColor(java.awt.Color color) 设置坐标轴颜色。
void	setAxesDisplayed(boolean value) 设置是否显示坐标轴。
void	setAxesGridDisplayed(boolean value) 设置是否在统计图坐标轴上显示网格。
void	setAxesTextDisplayed(boolean value) 设置是否显示坐标轴的文本标注。
void	setAxesTextDisplayMode(GraphAxesTextDisplayMode graphAxesTextDisplayMode) 设置显示坐标轴文本时，显示的文本模式，
void	setAxesTextStyle(TextStyle textStyle) 设置统计图坐标轴文本的风格。
void	setBarSpaceRatio(double value) 设置柱状专题图中柱体的间隔，设置的值为一个系数值，数值范围为0到10，默认值为1。
void	setBarWidth(double value) 已过时。
void	setBarWidthRatio(double value) 设置柱状专题图中每一个柱的宽度，设置的值为一个系数值，数值范围为0到10，默认值为1。
void	setCustomGraphSizeExpression(java.lang.String value) 设置一个字段表达式，该字段表达式用于控制对象对应的统计专题图元素的大小，字段表达式中的字段必须为数值型字段。
void	setFlowEnabled(boolean value) 设置统计专题图是否流动显示。
void	setGlobalMaxValueEnabled(boolean value) 设置是否使用全局最大值制作统计专题图。
void	setGraduatedMode(GraduatedMode value) 设置专题图分级模式。
void	setGraphSizeFixed(boolean value) 设置在放大或者缩小地图时统计图是否固定大小。
void	setGraphTextDisplayed(boolean value) 设置是否显示统计图上的文本标注。
void	setGraphTextFormat(ThemeGraphTextFormat themeGraphTextFormat) 设置统计专题图文本显示格式，如百分数、真实数值、标题、标题+百分数、标题+真实数值。
void	setGraphTextStyle(TextStyle textStyle) 设置统计图上的文字标注风格。
void	setGraphType(ThemeGraphType themeGraphType) 设置统计专题图的统计图类型。
void	setItem(int index, ThemeGraphItem item) 用指定的统计专题图子项替代指定序号上的专题图子项。
void	setLeaderLineDisplayed(boolean value) 设置是否显示统计图和它所表示的对象之间的牵引线。
void	setLeaderLineStyle(GeoStyle style) 设置统计图与其表示对象之间牵引线的风格。
void	setMaxGraphSize(double value) 设置统计专题图中统计符号显示的最大值。
void	setMemoryKeys(int[] values) 设置以内存数组方式制作专题图时的键数组。
void	setMinGraphSize(double value) 设置统计专题图中统计符号显示的最小值。
void	setNegativeDisplayed(boolean value) 设置专题图中是否显示属性为负值的数据。
void	setOffsetFixed(boolean value) 设置统计图是否固定偏移量。
void	setOffsetX(java.lang.String value) 设置统计图的水平偏移量。
void	setOffsetY(java.lang.String value) 设置统计图的垂直偏移量。
void	setOverlapAvoided(boolean value) 设置统计图是否采用避让方式显示。
void	setRoseAngle(double value) 设置统计图中玫瑰图或三维玫瑰图分片的角度。
void	setStartAngle(double value) 设置饼状统计图的起始角度，默认以水平方向为正向。
java.lang.String	toString() 输出专题图格式化字符串。

从类 com.supermap.mapping.Theme 继承的方法

fromXML, getMemoryData, getType, setMemoryData, toXML

从类 java.lang.Object 继承的方法

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

构造方法详细信息

ThemeGraph

public ThemeGraph()

默认构造函数，构造一个新的 ThemeGraph 对象。

ThemeGraph

public ThemeGraph(ThemeGraph themeGraph)

拷贝构造函数，根据给定的 ThemeGraph 对象构造一个与其完全相同的新对象。

参数：

themeGraph - 给定的 ThemeGraph 对象。

方法详细信息

getItem

public ThemeGraphItem getItem(int index)

返回指定序号的统计专题图子项。

参数：

index - 指定的序号。

返回：

指定序号的统计专题图子项。

setItem

public void setItem(int index,
                    ThemeGraphItem item)

用指定的统计专题图子项替代指定序号上的专题图子项。

参数：

index - 指定的序号。

item - 指定的统计专题图子项。

getCount

public int getCount()

返回统计专题图子项的个数。

返回：

统计专题图子项的个数。

默认值:

默认值为 0。

getOffsetX

public java.lang.String getOffsetX()

返回统计图的水平偏移量。默认使用地图单位。

返回：

统计图的水平偏移量。

默认值:

默认值为一个空字符串。

setOffsetX

public void setOffsetX(java.lang.String value)

设置统计图的水平偏移量。默认使用地图单位。

参数：

value - 统计图的水平偏移量。

getOffsetY

public java.lang.String getOffsetY()

返回统计图的垂直偏移量。默认使用地图单位。

返回：

统计图的垂直偏移量。

默认值:

默认值为一个空字符串。

setOffsetY

public void setOffsetY(java.lang.String value)

设置统计图的垂直偏移量。默认使用地图单位。

参数：

value - 统计图的垂直偏移量。

getGraphType

public ThemeGraphType getGraphType()

返回统计专题图的统计图类型。根据实际的数据和用途的不同，可以选择不同类型的统计图。

SuperMap iObjects Java 支持15种类型的统计图类型。 其中包括面积图、阶梯图、折线图、点状图、柱状图、三维柱状图、饼图、三维饼图、玫瑰图、三维玫瑰图、面状金字塔图、堆叠柱状图、三维堆叠柱状图、环状图。 详细信息请参见 ThemeGraphType。

返回：

统计专题图的统计图类型。

默认值:

默认值为 ThemeGraphType.PIE3D。

setGraphType

public void setGraphType(ThemeGraphType themeGraphType)

设置统计专题图的统计图类型。根据实际的数据和用途的不同，可以选择不同类型的统计图。

SuperMap iObjects Java 支持15种类型的统计图类型。 其中包括面积图、阶梯图、折线图、点状图、柱状图、三维柱状图、饼图、三维饼图、玫瑰图、三维玫瑰图、面状金字塔图、堆叠柱状图、三维堆叠柱状图、环状图。 详细信息请参见 ThemeGraphType 枚举类。

参数：

themeGraphType - 统计专题图的统计图类型。

getBarWidth

@Deprecated
public double getBarWidth()

已过时。

返回柱状图中每一个柱的宽度。使用地图坐标单位。已过时，使用getBarWidthRatio()替代。

注意：只有选择的统计图类型为柱状图、三维柱状图、堆叠柱状图、三维堆叠柱状图时，此项才可设置。

返回：

柱状图中每一个柱的宽度。

默认值:

默认值为 0。

setBarWidth

@Deprecated
public void setBarWidth(double value)

已过时。

设置柱状图中每一个柱的宽度。使用地图坐标单位。已过时，使用setBarWidthRatio()替代。

注意：只有选择的统计图类型为柱状图、三维柱状图、堆叠柱状图、三维堆叠柱状图时，此项才可设置。

参数：

value - 柱状图中每一个柱的宽度。

getBarWidthRatio

public double getBarWidthRatio()

返回柱状专题图中每一个柱的宽度，返回值为一个系数值，数值范围为0到10，默认值为1。柱状统计图的柱宽等于原始柱宽乘以系数值。

返回：

返回柱状专题图中每一个柱的宽度，返回值为一个系数值，数值范围为0到10，默认值为1。柱状统计图的柱宽等于原始柱宽乘以系数值。

setBarWidthRatio

public void setBarWidthRatio(double value)

设置柱状专题图中每一个柱的宽度，设置的值为一个系数值，数值范围为0到10，默认值为1。柱状统计图的柱宽等于原始柱宽乘以系数值。

参数：

value - 柱状专题图中每一个柱的宽度，该值为一个系数值，数值范围为0到10，默认值为1。柱状统计图的柱宽等于原始柱宽乘以系数值。

getBarSpaceRatio

public double getBarSpaceRatio()

返回柱状专题图中柱体的间隔，返回值为一个系数值，数值范围为0到10，默认值为1。柱状统计图的柱体间隔等于原始间隔乘以系数值。

返回：

柱状专题图中柱体的间隔，返回值为一个系数值，数值范围为0到10，默认值为0.618。柱状统计图的柱体间隔等于原始间隔乘以系数值。

setBarSpaceRatio

public void setBarSpaceRatio(double value)

设置柱状专题图中柱体的间隔，设置的值为一个系数值，数值范围为0到10，默认值为1。柱状统计图的柱体间隔等于原始间隔乘以系数值。

参数：

value - 柱状专题图中柱体的间隔，该值为一个系数值，数值范围为0到10，默认值为0.618。柱状统计图的柱体间隔等于原始间隔乘以系数值。

getStartAngle

public double getStartAngle()

返回饼状统计图的起始角度，默认以水平方向为正向。单位为度，精确到 0.1 度。

注意：只有选择的统计图类型为饼状图（饼图、三维饼图、玫瑰图、三维玫瑰图）时，此项才可设置。

返回：

饼状统计图的起始角度。

默认值:

默认值为 0。

setStartAngle

public void setStartAngle(double value)

设置饼状统计图的起始角度，默认以水平方向为正向。单位为度，精确到 0.1 度。

注意：只有选择的统计图类型为饼状图（饼图、三维饼图、玫瑰图、三维玫瑰图）时，此项才可设置。

参数：

value - 饼状统计图的起始角度。

getRoseAngle

public double getRoseAngle()

返回统计图中玫瑰图或三维玫瑰图分片的角度。单位为度，精确到 0.1 度。

返回：

统计图中玫瑰图或三维玫瑰图分片的角度。

默认值:

默认为 0 度。

setRoseAngle

public void setRoseAngle(double value)

设置统计图中玫瑰图或三维玫瑰图分片的角度。单位为度，精确到 0.1 度。

参数：

value - 统计图中玫瑰图或三维玫瑰图分片的角度。

isFlowEnabled

public boolean isFlowEnabled()

返回统计专题图是否流动显示。

返回：

一个布尔值指定统计专题图是否流动显示。

默认值:

默认为 true。

setFlowEnabled

public void setFlowEnabled(boolean value)

设置统计专题图是否流动显示。

该方法与Map.setDisableDynamicEffect() 方法相互冲突，即 setDisableDynamicEffect(true)时，即使该方法设置为true，统计专题图也无法流动显示。

参数：

value - 一个布尔值指定统计专题图是否流动显示。

getLeaderLineStyle

public GeoStyle getLeaderLineStyle()

返回统计图与其表示对象之间牵引线的风格。

返回：

统计图与其表示对象之间牵引线的风格。

默认值:

默认值为 {FillBackColor=Color [A=255, R=255, G=255, B=255],FillForeColor=Color [A=255, R=189, G=235, B=255],FillGradientAngle=0,FillGradientMode=None,FillGradientOffsetRatioX=0,FillGradientOffsetRatioY=0,FillOpaqueRate=100,FillSymbolID=0,LineColor=Color [A=255, R=0, G=0, B=0],LineSymbolID=39,LineWidth=0.1,MarkerAngle=0,MarkerSize={Width=2.4,Height=-1},MarkerSymbolID=0}。

setLeaderLineStyle

public void setLeaderLineStyle(GeoStyle style)

设置统计图与其表示对象之间牵引线的风格。

参数：

style - 统计图与其表示对象之间牵引线的风格。

isLeaderLineDisplayed

public boolean isLeaderLineDisplayed()

返回是否显示统计图和它所表示的对象之间的牵引线。如果渲染符号偏移该对象，图与对象之间可以采用牵引线进行连接。

返回：

一个布尔值指定是否显示统计图和它所表示的对象之间的牵引线。

默认值:

默认为 false，即不显示牵引线。

setLeaderLineDisplayed

public void setLeaderLineDisplayed(boolean value)

设置是否显示统计图和它所表示的对象之间的牵引线。如果渲染符号偏移该对象，图与对象之间可以采用牵引线进行连接。

参数：

value - 一个布尔值指定是否显示统计图和它所表示的对象之间的牵引线。

isNegativeDisplayed

public boolean isNegativeDisplayed()

返回专题图中是否显示属性为负值的数据。

该方法对面积图、阶梯图、折线图、点状图、柱状图、三维柱状图无效，因为在绘制时会始终显示负值数据；对于饼图、三维饼图、玫瑰图、三维玫瑰图、金字塔专题图-条形、金字塔专题图-面形，如果用户将该方法参数设为 true，则将负值取绝对值后按照正值进行处理，若设置为 false，则不对其进行绘制（正、负值数据均不绘制）。

返回：

一个布尔值指定专题图中是否显示属性为负值的数据。

默认值:

默认为 false，表示不显示。

setNegativeDisplayed

public void setNegativeDisplayed(boolean value)

设置专题图中是否显示属性为负值的数据。

该方法对面积图、阶梯图、折线图、点状图、柱状图、三维柱状图无效，因为在绘制时会始终显示负值数据；对于饼图、三维饼图、玫瑰图、三维玫瑰图、金字塔专题图-条形、金字塔专题图-面形，如果用户将该方法参数设为 true，则将负值取绝对值后按照正值进行处理，若设置为 false，则不对其进行绘制（正、负值数据均不绘制）。

参数：

value - 一个布尔值指定专题图中是否显示属性为负值的数据。

getAxesColor

public java.awt.Color getAxesColor()

返回坐标轴颜色。

返回：

坐标轴颜色。

默认值:

默认值为 Color [A=255, R=128, G=128, B=128]。

setAxesColor

public void setAxesColor(java.awt.Color color)

设置坐标轴颜色。

参数：

color - 坐标轴颜色。

isAxesDisplayed

public boolean isAxesDisplayed()

返回是否显示坐标轴。

返回：

一个布尔值指定是否显示坐标轴。

默认值:

默认值为 true。

setAxesDisplayed

public void setAxesDisplayed(boolean value)

设置是否显示坐标轴。

参数：

value - 一个布尔值指定是否显示坐标轴。

getAxesTextStyle

public TextStyle getAxesTextStyle()

返回统计图坐标轴文本的风格。

返回：

统计图坐标轴文本的风格。

默认值:

默认值为 {Alignment=BottomRight,BackColor=Color [A=255, R=0, G=0, B=0],BackOpaque=False,Bold=False,FontHeight=6,FontWidth=0,ForeColor=Color [A=255, R=0, G=0, B=0],IsSizeFixed=False,Italic=False,Outline=False,Rotation=0,Shadow=False,Strikeout=False,Underline=False,Weight=0}

setAxesTextStyle

public void setAxesTextStyle(TextStyle textStyle)

设置统计图坐标轴文本的风格。

参数：

textStyle - 统计图坐标轴文本的风格。

isAxesTextDisplayed

public boolean isAxesTextDisplayed()

返回是否显示坐标轴的文本标注。

返回：

一个布尔值指定是否显示坐标轴的文本标注。

默认值:

默认值为 false。

setAxesTextDisplayed

public void setAxesTextDisplayed(boolean value)

设置是否显示坐标轴的文本标注。

参数：

value - 一个布尔值指定是否显示坐标轴的文本标注。

isAxesGridDisplayed

public boolean isAxesGridDisplayed()

返回是否在统计图坐标轴上显示网格。

返回：

一个布尔值指定是否在统计图坐标轴上显示网格。

默认值:

默认值为 false。

setAxesGridDisplayed

public void setAxesGridDisplayed(boolean value)

设置是否在统计图坐标轴上显示网格。

参数：

value - 一个布尔值指定是否在统计图坐标轴上显示网格。

getGraphTextStyle

public TextStyle getGraphTextStyle()

返回统计图上的文字标注风格。

统计专题图上坐标轴的文本对齐方式均采用右下角的对齐方式，以防止坐标轴压盖文本

返回：

统计图上的文字标注风格。

默认值:

默认值为 {Alignment=MiddleCenter,BackColor=Color [A=255, R=0, G=0, B=0],BackOpaque=False,Bold=False,FontHeight=4,FontWidth=0,ForeColor=Color [A=255, R=0, G=0, B=255],IsSizeFixed=True,Italic=False,Outline=False,Rotation=0,Shadow=False,Strikeout=False,Underline=False,Weight=0}

setGraphTextStyle

public void setGraphTextStyle(TextStyle textStyle)

设置统计图上的文字标注风格。

统计专题图上坐标轴的文本对齐方式均采用右下角的对齐方式，以防止坐标轴压盖文本

参数：

textStyle - 统计图上的文字标注风格。

getGraphTextFormat

public ThemeGraphTextFormat getGraphTextFormat()

返回统计专题图文本显示格式，如百分数、真实数值、标题、标题+百分数、标题+真实数值。有关统计专题图文本显示格式详细信息，请参考 ThemeGraphTextFormat。

返回：

统计专题图文本显示格式。

默认值:

默认值为 ThemeGraphTextFormat.PERCENT。

setGraphTextFormat

public void setGraphTextFormat(ThemeGraphTextFormat themeGraphTextFormat)

设置统计专题图文本显示格式，如百分数、真实数值、标题、标题+百分数、标题+真实数值。有关统计专题图文本显示格式详细信息，请参考 ThemeGraphTextFormat。

参数：

themeGraphTextFormat - 统计专题图文本显示格式。

isGraphTextDisplayed

public boolean isGraphTextDisplayed()

返回是否显示统计图上的文本标注。

返回：

一个布尔值指定是否显示统计图上的文本标注。

默认值:

默认值为 false。

setGraphTextDisplayed

public void setGraphTextDisplayed(boolean value)

设置是否显示统计图上的文本标注。

参数：

value - 一个布尔值指定是否显示统计图上的文本标注。

getMinGraphSize

public double getMinGraphSize()

返回统计专题图中统计符号显示的最小值。

统计图中统计符号的显示大小均在最大、最小值之间逐渐变化。统计图的最大、最小值是与统计对象的多少和图层大小相关系的一个值。

当 isGraphSizeFixed() 方法返回值为 true 时，单位为 0.01mm；当 isGraphSizeFixed() 方法返回值为 false 时，使用地图单位。

返回：

统计专题图中统计符号显示的最小值。

默认值:

默认值为 0。

setMinGraphSize

public void setMinGraphSize(double value)

设置统计专题图中统计符号显示的最小值。

统计图中统计符号的显示大小均在最大、最小值之间逐渐变化。统计图的最大、最小值是与统计对象的多少和图层大小相关系的一个值。

当 isGraphSizeFixed() 方法返回值为 true 时，单位为 0.01mm；当 isGraphSizeFixed() 方法返回值为 false 时，使用地图单位。

参数：

value - 统计专题图中统计符号显示的最小值。

getMaxGraphSize

public double getMaxGraphSize()

返回统计专题图中统计符号显示的最大值。

统计图中统计符号的显示大小均在最大、最小值之间逐渐变化。统计图的最大、最小值是与统计对象的多少和图层大小相关系的一个值。

当 isGraphSizeFixed() 方法返回值为 true 时，单位为 0.01mm；当 isGraphSizeFixed() 方法返回值为 false 时，使用地图单位。

返回：

统计专题图中统计符号显示的最大值。

默认值:

默认值为 0。

setMaxGraphSize

public void setMaxGraphSize(double value)

设置统计专题图中统计符号显示的最大值。

统计图中统计符号的显示大小均在最大、最小值之间逐渐变化。统计图的最大、最小值是与统计对象的多少和图层大小相关系的一个值。

当 isGraphSizeFixed() 方法返回值为 true 时，单位为 0.01mm；当 isGraphSizeFixed() 方法返回值为 false 时，使用地图单位。

参数：

value - 统计专题图中统计符号显示的最大值。

getGraduatedMode

public GraduatedMode getGraduatedMode()

返回专题图分级模式。其中包括常量分级、对数分级和平方根分级。详情请参考 GraduatedMode。

返回：

专题图分级模式。

默认值:

默认值为 GraduatedMode.CONSTANT。

setGraduatedMode

public void setGraduatedMode(GraduatedMode value)

设置专题图分级模式。其中包括常量分级、对数分级和平方根分级。详情请参考 GraduatedMode。

参数：

value - 专题图分级模式。

isGraphSizeFixed

public boolean isGraphSizeFixed()

返回在放大或者缩小地图时统计图是否固定大小。

返回：

一个布尔值指定在放大或者缩小地图时统计图是否固定大小。

默认值:

默认值为 false。

setGraphSizeFixed

public void setGraphSizeFixed(boolean value)

设置在放大或者缩小地图时统计图是否固定大小。

参数：

value - 一个布尔值指定在放大或者缩小地图时统计图是否固定大小。

isOverlapAvoided

public boolean isOverlapAvoided()

返回统计图是否采用避让方式显示。

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

返回：

一个布尔值，采用避让方式显示返回 true，否则返回 false。

默认值:

默认值为 false。

setOverlapAvoided

public void setOverlapAvoided(boolean value)

设置统计图是否采用避让方式显示。

该方法与Map.setDisableDynamicEffect() 方法相互冲突，即 setDisableDynamicEffect(true)时，即使该方法设置为true，统计专题图也无法自动避让。

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

参数：

value - 一个布尔值指定是否采用避让方式显示统计图。

isOffsetFixed

public boolean isOffsetFixed()

返回统计图是否固定偏移量。固定偏移量，则统计图的偏移量不随地图的缩放而变化。

返回：

一个布尔值，固定偏移量返回 true，否则返回 false。

默认值:

默认值为 false。

setOffsetFixed

public void setOffsetFixed(boolean value)

设置统计图是否固定偏移量。固定偏移量，则统计图的偏移量不随地图的缩放而变化。

参数：

value - 一个布尔值指定是否固定偏移量。

add

public int add(ThemeGraphItem item)

添加统计专题图的子项到专题图子项列表中。

参数：

item - 被添加的统计专题图子项。

返回：

如果添加成功返回被添加子项在子项序列中的序号，否则返回 -1。

insert

public boolean insert(int index,
                      ThemeGraphItem item)

将给定的统计专题图子项插入到指定序号的位置。

参数：

index - 指定的统计专题图子项序列的序号。

item - 将被插入的统计专题图子项。

返回：

一个布尔值，如果插入成功返回值为 true，否则为 false。

exchangeItem

public boolean exchangeItem(int index1,
                            int index2)

将指定序号的两个子项进行位置交换。

参数：

index1 - 指定的交换的第一个子项的序号。

index2 - 指定的交换第二个子项的序号。

返回：

一个布尔值，如果两个子项交换成功，返回 true； 否则返回 false。

indexOf

public int indexOf(java.lang.String graphExpression)

返回统计专题图中指定统计字段表达式的对象在当前统计图子项序列中的序号。

参数：

graphExpression - 指定的统计字段表达式。

返回：

统计专题图子项在序列中的序号。

remove

public boolean remove(int index)

在统计专题图子项序列中删除指定序号的统计专题图子项。

参数：

index - 指定的将被删除子项的序号。

返回：

如果删除成功，返回 true；否则返回 false。

clear

public void clear()

删除统计专题图中的所有子项。

dispose

public void dispose()

释放对象所占用的资源。调用该方法之后，此对象不再可用。

getMemoryKeys

public int[] getMemoryKeys()

返回以内存数组方式制作专题图时的键数组。

键数组内的数值代表 SmID 值。键数组中数值的个数必须要与值数组（通过 ThemeGraphItem.setMemoryDoubleValues() 方法进行设置）的数值个数一致。值数组中的值将代替原来的专题值来制作统计专题图。

比如：利用面积字段和周长字段（即有两个 item）作为专题变量制作统计专题图。

键数组设置为（1，3，8，9）

专题变量为“面积”的值数组设置为（5.2，6.1，3.4，8.5）

专题变量为“周长”的值数组设置为（10.2，12.44，6.4，16.1）

则制作完成后会有四个统计图，分别为 SmID 值为1，3，8，9的记录所对应的统计图，每个统计图有两项，分别代表面积和周长。

需要注意的是，此时 SmID 值为1的记录，其对应的面积字段的值用值数组的 “5.2” 代替，周长字段的值用值数组的 “10.2” 代替；SmID 值为 3 的记录，其对应的面积字段的值用值数组的 “6.1” 代替，周长字段的值用值数组的 “12.44” 代替，以此类推。

返回：

以内存数组方式制作专题图时的键数组。

setMemoryKeys

public void setMemoryKeys(int[] values)

设置以内存数组方式制作专题图时的键数组。

键数组内的数值代表 SmID 值，它与 ThemeGraphItem 类中设置值数组的方法（即 ThemeGraphItem.setMemoryDoubleValues() 方法）要关联起来应用。键数组中数值的个数必须要与值数组的数值个数一致。值数组中的值将代替原来的专题值来制作统计专题图。

比如：利用面积字段和周长字段（即有两个 item）作为专题变量制作统计专题图。

键数组设置为（1，3，8，9）

专题变量为“面积”的值数组设置为（5.2，6.1，3.4，8.5）

专题变量为“周长”的值数组设置为（10.2，12.44，6.4，16.1）

则制作完成后会有四个统计图，分别为 SmID 值为1，3，8，9的记录所对应的统计图，每个统计图有两项，分别代表面积和周长。

需要注意的是，此时 SmID 值为1的记录，其对应的面积字段的值用值数组的 “5.2” 代替，周长字段的值用值数组的 “10.2” 代替；SmID 值为 3 的记录，其对应的面积字段的值用值数组的“6.1”代替，周长字段的值用值数组的 “12.44” 代替，以此类推。

参数：

values - 以内存数组方式制作专题图时的键数组。

toString

public java.lang.String toString()

从类 Theme 复制的描述

输出专题图格式化字符串。格式化字符串提供专题图的相关设置信息，与 XML 字符串不同的是，格式化字符串不可导入显示专题图，只用于提供专题图的相关信息。

1. 对于栅格分段专题图，其格式为{Caption=”china”, Start=10 End=20, Visible=true?false, Style={linestyle=,markerstyle=,fillstyle=} }；
2. 对于栅格单值专题图，其格式为{Caption=”china”, Unique =20, Visible=true?false, Style={linestyle=,markerstyle=,fillstyle=} }；
3. 对于标签专题图，其格式为{Caption=”China”, Start=10 End=20, Visible=true, Style={name=,width=,height=,color=()} }；
4. 对于分段专题图，其格式为{Caption=”china”, Start=10 End=20, Visible=true?false, Style={linestyle=,markerstyle=,fillstyle=}；
5. 对于单值专题图，其格式为{Caption=”china”, Unique =20, Visible=true?false, Style={linestyle=,markerstyle=,fillstyle=} }。

指定者：

类 Theme 中的 toString

返回：

专题图的格式化字符串。

isAllDirectionsOverlappedAvoided

public boolean isAllDirectionsOverlappedAvoided()

设置是否允许以全方向统计专题图避让。

通常统计专题图避让是以全方向进行的，虽然避让比较合理，但会影响显示效率；如果提高显示效率，请设置 setAllDirectionsOverlappedAvoided() 方法为 false。

全方向即指以统计专题图外边框和基准线而形成的 12 个方向。

四方向是指以统计专题图外边矩形框的四个角点方向。

返回：

如果全方向统计专题图避让即为 true，如果四方向统计专题图避让为 false。

setAllDirectionsOverlappedAvoided

public void setAllDirectionsOverlappedAvoided(boolean value)

设置是否允许以全方向统计专题图避让。

通常统计专题图避让是以全方向进行的，虽然避让比较合理，但会影响显示效率；如果提高显示效率，请设置 setAllDirectionsOverlappedAvoided() 方法为 false。

参数：

value - 一个布尔值指定是否以全方向统计专题图避让。

getAxesTextDisplayMode

public GraphAxesTextDisplayMode getAxesTextDisplayMode()

返回显示坐标轴文本时，显示的文本模式，

返回：

显示坐标轴文本时，显示的文本模式，

setAxesTextDisplayMode

public void setAxesTextDisplayMode(GraphAxesTextDisplayMode graphAxesTextDisplayMode)

设置显示坐标轴文本时，显示的文本模式，

参数：

graphAxesTextDisplayMode - 显示坐标轴文本时，显示的文本模式，

getCustomGraphSizeExpression

public java.lang.String getCustomGraphSizeExpression()

返回一个字段表达式，该字段表达式用于控制对象对应的统计专题图元素的大小，字段表达式中的字段必须为数值型字段。 该字段表达式可以指定一个字段也可以指定一个字段表达式；还可以指定一个数值，此时所有专题图子项将以该数值指定的大小统一显示。

返回：

返回一个字段表达式。

setCustomGraphSizeExpression

public void setCustomGraphSizeExpression(java.lang.String value)

设置一个字段表达式，该字段表达式用于控制对象对应的统计专题图元素的大小，字段表达式中的字段必须为数值型字段。 该字段表达式可以指定一个字段也可以指定一个字段表达式；还可以指定一个数值，此时所有专题图子项将以该数值指定的大小统一显示。

参数：

value - 返回一个字段表达式。

setGlobalMaxValueEnabled

public void setGlobalMaxValueEnabled(boolean value)

设置是否使用全局最大值制作统计专题图。true，表示使用全局最大值作为统计图元素的最大值，保证同一专题图层中统计图元素具有一致的刻度。

参数：

value - 一个布尔值，指示是否使用全局最大值制作统计专题图。true，表示使用全局最大值作为统计图元素的最大值，保证同一专题图层中统计图元素具有一致的刻度。

isGlobalMaxValueEnabled

public boolean isGlobalMaxValueEnabled()

返回是否使用全局最大值制作统计专题图。true，表示使用全局最大值作为统计图元素的最大值，保证同一专题图层中统计图元素具有一致的刻度。

返回：

一个布尔值，指示是否使用全局最大值制作统计专题图。true，表示使用全局最大值作为统计图元素的最大值，保证同一专题图层中统计图元素具有一致的刻度。