类 ThemeGraph
- java.lang.Object
-
- com.supermap.data.InternalHandle
-
- com.supermap.data.InternalHandleDisposable
-
- com.supermap.mapping.Theme
-
- com.supermap.mapping.ThemeGraph
-
- 所有已实现的接口:
- IDisposable
public class ThemeGraph extends Theme
统计专题图类。统计专题图通过为每个要素或记录绘制统计图来反映其对应的专题值的大小。统计专题图可以基于多个变量,反映多种属性,即可以将多个专题变量的值绘制在一个统计图上。
目前提供的统计图类型有:面积图、阶梯图、折线图、点状图、柱状图、三维柱状图、饼图、三维饼图、玫瑰图、三维玫瑰图、面状金字塔图、堆叠柱状图、三维堆叠柱状图、环状图。 注:用来制作专题图的数据称为专题变量。
-
-
构造器概要
构造器 构造器和说明 ThemeGraph()
默认构造函数,构造一个新的ThemeGraph
对象。ThemeGraph(ThemeGraph themeGraph)
拷贝构造函数,根据给定的ThemeGraph
对象构造一个与其完全相同的新对象。
-
方法概要
所有方法 实例方法 具体方法 已过时的方法 限定符和类型 方法和说明 int
add(ThemeGraphItem item)
添加统计专题图的子项到专题图子项列表中。void
calculateExtremum()
计算统计专题图各个段的极值void
calculateExtremum(Dataset dataset)
计算统计专题图各个段的极值void
clear()
删除统计专题图中的所有子项。void
dispose()
释放对象所占用的资源。boolean
exchangeItem(int index1, int index2)
将指定序号的两个子项进行位置交换。boolean
fromXML(String xml)
从 XML 字符串中导入专题图信息。Color
getAxesColor()
返回坐标轴颜色。GraphAxesTextDisplayMode
getAxesTextDisplayMode()
返回显示坐标轴文本时,显示的文本模式,TextStyle
getAxesTextStyle()
返回统计图坐标轴文本的风格。double
getBarSpaceRatio()
返回柱状专题图中柱体的间隔,返回值为一个系数值,数值范围为0到10,默认值为1。double
getBarWidth()
已过时。使用getBarWidthRatio()
替代。double
getBarWidthRatio()
返回柱状专题图中每一个柱的宽度,返回值为一个系数值,数值范围为0到10,默认值为1。int
getCount()
返回统计专题图子项的个数。String
getCustomGraphSizeExpression()
返回一个字段表达式,该字段表达式用于控制对象对应的统计专题图元素的大小,字段表达式中的字段必须为数值型字段。GraduatedMode
getGraduatedMode()
返回专题图分级模式。ThemeGraphTextFormat
getGraphTextFormat()
返回统计专题图文本显示格式,如百分数、真实数值、标题、标题+百分数、标题+真实数值。TextStyle
getGraphTextStyle()
返回统计图上的文字标注风格。ThemeGraphType
getGraphType()
返回统计专题图的统计图类型。ThemeGraphItem
getItem(int index)
返回指定序号的统计专题图子项。GeoStyle
getLeaderLineStyle()
返回统计图与其表示对象之间牵引线的风格。double
getMaxGraphSize()
返回统计专题图中统计符号显示的最大值。int[]
getMemoryKeys()
返回以内存数组方式制作专题图时的键数组。double
getMinGraphSize()
返回统计专题图中统计符号显示的最小值。String
getOffsetX()
返回统计图的水平偏移量。String
getOffsetY()
返回统计图的垂直偏移量。double
getRoseAngle()
返回统计图中玫瑰图或三维玫瑰图分片的角度。double
getStartAngle()
返回饼状统计图的起始角度,默认以水平方向为正向。String
getStrUnitYAxirShow()
获取统计专题图Y轴显示单位字符串int
getValueDigit()
获取显示精度(标注格式在使用真实值设置时)int
indexOf(String graphExpression)
返回统计专题图中指定统计字段表达式的对象在当前统计图子项序列中的序号。boolean
insert(int index, ThemeGraphItem item)
将给定的统计专题图子项插入到指定序号的位置。boolean
IsAllDirectionsOverlapedAvoided()
已过时。boolean
isAllDirectionsOverlappedAvoided()
设置是否允许以全方向统计专题图避让。boolean
isAxesDisplayed()
返回是否显示坐标轴。boolean
isAxesGridDisplayed()
返回是否在统计图坐标轴上显示网格。boolean
isAxesTextDisplayed()
返回是否显示坐标轴的文本标注。boolean
isDigitAlign()
是否为补零对齐(标注格式在使用真实值设置时)boolean
isFlowEnabled()
返回统计专题图是否流动显示。boolean
isGlobalMaxValueEnabled()
返回是否使用全局最大值制作统计专题图。boolean
isGraphSizeFixed()
返回在放大或者缩小地图时统计图是否固定大小。boolean
isGraphTextDisplayed()
返回是否显示统计图上的文本标注。boolean
isLeaderLineDisplayed()
返回是否显示统计图和它所表示的对象之间的牵引线。boolean
isNegativeDisplayed()
返回专题图中是否显示属性为负值的数据。boolean
isOffsetFixed()
返回统计图是否固定偏移量。boolean
isOverlapAvoided()
返回统计图是否采用避让方式显示。boolean
remove(int index)
在统计专题图子项序列中删除指定序号的统计专题图子项。void
setAllDirectionsOverlapedAvoided(boolean value)
已过时。void
setAllDirectionsOverlappedAvoided(boolean value)
设置是否允许以全方向统计专题图避让。void
setAxesColor(Color color)
设置坐标轴颜色。void
setAxesDisplayed(boolean value)
设置是否显示坐标轴。void
setAxesGridDisplayed(boolean value)
设置是否在统计图坐标轴上显示网格。void
setAxesTextDisplayed(boolean value)
设置是否显示坐标轴的文本标注。void
setAxesTextDisplayMode(GraphAxesTextDisplayMode mode)
设置显示坐标轴文本时,显示的文本模式,void
setAxesTextStyle(TextStyle textStyle)
设置统计图坐标轴文本的风格。void
setBarSpaceRatio(double value)
设置柱状专题图中柱体的间隔,设置的值为一个系数值,数值范围为0到10,默认值为1。void
setBarWidth(double value)
已过时。使用setBarWidthRatio()
替代。void
setBarWidthRatio(double value)
设置柱状专题图中每一个柱的宽度,设置的值为一个系数值,数值范围为0到10,默认值为1。void
setCustomGraphSizeExpression(String value)
设置一个字段表达式,该字段表达式用于控制对象对应的统计专题图元素的大小,字段表达式中的字段必须为数值型字段。void
setDigitAlign(boolean 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[] keys)
设置以内存数组方式制作专题图时的键数组。void
setMinGraphSize(double value)
设置统计专题图中统计符号显示的最小值。void
setNegativeDisplayed(boolean value)
设置专题图中是否显示属性为负值的数据。void
setOffsetFixed(boolean value)
设置统计图是否固定偏移量。void
setOffsetX(String value)
设置统计图的水平偏移量。void
setOffsetY(String value)
设置统计图的垂直偏移量。void
setOverlapAvoided(boolean value)
设置统计图是否采用避让方式显示。void
setRoseAngle(double value)
设置统计图中玫瑰图或三维玫瑰图分片的角度。void
setStartAngle(double value)
设置饼状统计图的起始角度,默认以水平方向为正向。void
setStrUnitYAxirShow(String value)
设置统计专题图Y轴显示单位字符串void
setValueDigit(int value)
设置显示精度String
toString()
输出专题图格式化字符串。-
从类继承的方法 com.supermap.mapping.Theme
getMemoryData, getThemeWeight, getType, setMemoryData, setThemeWeight, toXML
-
-
-
-
构造器详细资料
-
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。
-
isGraphSizeFixed
public boolean isGraphSizeFixed()
返回在放大或者缩小地图时统计图是否固定大小。- 返回:
- 一个布尔值指定在放大或者缩小地图时统计图是否固定大小。
- 默认值:
- 默认值为 false。
-
setGraphSizeFixed
public void setGraphSizeFixed(boolean value)
设置在放大或者缩小地图时统计图是否固定大小。- 参数:
value
- 一个布尔值指定在放大或者缩小地图时统计图是否固定大小。
-
getOffsetX
public String getOffsetX()
返回统计图的水平偏移量。默认使用地图单位。- 返回:
- 统计图的水平偏移量。
- 默认值:
- 默认值为一个空字符串。
-
setOffsetX
public void setOffsetX(String value)
设置统计图的水平偏移量。默认使用地图单位。- 参数:
value
- 统计图的水平偏移量。
-
getOffsetY
public String getOffsetY()
返回统计图的垂直偏移量。默认使用地图单位。- 返回:
- 统计图的垂直偏移量。
- 默认值:
- 默认值为一个空字符串。
-
setOffsetY
public void setOffsetY(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()
替代。返回柱状图中每一个柱的宽度。使用地图坐标单位。已过时,使用getBarWidthRatio()
替代。注意:只有选择的统计图类型为柱状图、三维柱状图、堆叠柱状图、三维堆叠柱状图时,此项才可设置。
- 返回:
- 柱状图中每一个柱的宽度。
- 默认值:
- 默认值为 0。
-
setBarWidth
@Deprecated public void setBarWidth(double value)
已过时。 使用setBarWidthRatio()
替代。设置柱状图中每一个柱的宽度。使用地图坐标单位。已过时,使用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 Color getAxesColor()
返回坐标轴颜色。- 返回:
- 坐标轴颜色。
- 默认值:
- 默认值为 Color [A=255, R=128, G=128, B=128]。
-
setAxesColor
public void setAxesColor(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
- 一个布尔值指定是否显示统计图上的文本标注。
-
isOffsetFixed
public boolean isOffsetFixed()
返回统计图是否固定偏移量。固定偏移量,则统计图的偏移量不随地图的缩放而变化。- 返回:
- 一个布尔值,固定偏移量返回 true,否则返回 false。
- 默认值:
- 默认值为 false。
-
setOffsetFixed
public void setOffsetFixed(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
- 统计专题图中统计符号显示的最大值。
-
getCustomGraphSizeExpression
public String getCustomGraphSizeExpression()
返回一个字段表达式,该字段表达式用于控制对象对应的统计专题图元素的大小,字段表达式中的字段必须为数值型字段。 该字段表达式可以指定一个字段也可以指定一个字段表达式;还可以指定一个数值,此时所有专题图子项将以该数值指定的大小统一显示。- 返回:
- 返回一个字段表达式。
-
setCustomGraphSizeExpression
public void setCustomGraphSizeExpression(String value)
设置一个字段表达式,该字段表达式用于控制对象对应的统计专题图元素的大小,字段表达式中的字段必须为数值型字段。 该字段表达式可以指定一个字段也可以指定一个字段表达式;还可以指定一个数值,此时所有专题图子项将以该数值指定的大小统一显示。- 参数:
value
- 返回一个字段表达式。
-
getGraduatedMode
public GraduatedMode getGraduatedMode()
返回专题图分级模式。其中包括常量分级、对数分级和平方根分级。详情请参考GraduatedMode
。- 返回:
- 专题图分级模式。
- 默认值:
- 默认值为
GraduatedMode.CONSTANT
。
-
setGraduatedMode
public void setGraduatedMode(GraduatedMode value)
设置专题图分级模式。其中包括常量分级、对数分级和平方根分级。详情请参考GraduatedMode
。- 参数:
value
- 专题图分级模式。
-
isOverlapAvoided
public boolean isOverlapAvoided()
返回统计图是否采用避让方式显示。- 对数据集制作统计专题图 当统计图采用避让方式显示时,如果
- 对数据集同时制作统计专题图和标签专题图
- 当统计图不显示子项文本时,标签专题图的标签即使和统计图重叠,两者也都可正常显示;
- 当统计图显示子项文本时,如果统计图中的子项文本和标签专题图中的标签不重叠,则两者均正常显示;如果重叠,则会过滤掉统计图的子项文本,只显示标签。
Map.setOverlapDisplayed()
方法设置为 true,则在统计图重叠度很大的情况下,会出现无法完全避免统计图重叠的现象;当Map.setOverlapDisplayed()
方法设置为 false 时,会过滤掉一些统计图,从而保证所有的统计图均不重叠。- 返回:
- 一个布尔值,采用避让方式显示返回 true,否则返回 false。
- 默认值:
- 默认值为 false。
-
setOverlapAvoided
public void setOverlapAvoided(boolean value)
设置统计图是否采用避让方式显示。该方法与
Map.setDisableDynamicEffect()
方法相互冲突,即 setDisableDynamicEffect(true)时,即使该方法设置为true,统计专题图也无法自动避让。- 对数据集制作统计专题图 当统计图采用避让方式显示时,如果
- 对数据集同时制作统计专题图和标签专题图
- 当统计图不显示子项文本时,标签专题图的标签即使和统计图重叠,两者也都可正常显示;
- 当统计图显示子项文本时,如果统计图中的子项文本和标签专题图中的标签不重叠,则两者均正常显示;如果重叠,则会过滤掉统计图的子项文本,只显示标签。
Map.setOverlapDisplayed()
方法设置为 true,则在统计图重叠度很大的情况下,会出现无法完全避免统计图重叠的现象;当Map.setOverlapDisplayed()
方法设置为 false 时,会过滤掉一些统计图,从而保证所有的统计图均不重叠。- 参数:
value
- 一个布尔值指定是否采用避让方式显示统计图。
-
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[] keys)
设置以内存数组方式制作专题图时的键数组。键数组内的数值代表 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
- 以内存数组方式制作专题图时的键数组。
-
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(String graphExpression)
返回统计专题图中指定统计字段表达式的对象在当前统计图子项序列中的序号。- 参数:
graphExpression
- 指定的统计字段表达式。- 返回:
- 统计专题图子项在序列中的序号。
-
remove
public boolean remove(int index)
在统计专题图子项序列中删除指定序号的统计专题图子项。- 参数:
index
- 指定的将被删除子项的序号。- 返回:
- 如果删除成功,返回 true;否则返回 false。
-
clear
public void clear()
删除统计专题图中的所有子项。
-
toString
public String toString()
从类复制的说明:Theme
输出专题图格式化字符串。格式化字符串提供专题图的相关设置信息,与 XML 字符串不同的是,格式化字符串不可导入显示专题图,只用于提供专题图的相关信息。- 对于栅格分段专题图,其格式为{Caption=”china”, Start=10 End=20, Visible=true?false, Style={linestyle=,markerstyle=,fillstyle=} };
- 对于栅格单值专题图,其格式为{Caption=”china”, Unique =20, Visible=true?false, Style={linestyle=,markerstyle=,fillstyle=} };
- 对于标签专题图,其格式为{Caption=”China”, Start=10 End=20, Visible=true, Style={name=,width=,height=,color=()} };
- 对于分段专题图,其格式为{Caption=”china”, Start=10 End=20, Visible=true?false, Style={linestyle=,markerstyle=,fillstyle=};
- 对于单值专题图,其格式为{Caption=”china”, Unique =20, Visible=true?false, Style={linestyle=,markerstyle=,fillstyle=} }。
-
setAxesTextDisplayMode
public void setAxesTextDisplayMode(GraphAxesTextDisplayMode mode)
设置显示坐标轴文本时,显示的文本模式,- 参数:
mode
- 显示坐标轴文本时,显示的文本模式,
-
getAxesTextDisplayMode
public GraphAxesTextDisplayMode getAxesTextDisplayMode()
返回显示坐标轴文本时,显示的文本模式,- 返回:
- 显示坐标轴文本时,显示的文本模式,
-
dispose
public void dispose()
释放对象所占用的资源。调用该方法之后,此对象不再可用。
-
IsAllDirectionsOverlapedAvoided
@Deprecated public boolean IsAllDirectionsOverlapedAvoided()
已过时。废弃,参见:isAllDirectionsOverlappedAvoided- 返回:
- 抛出:
IllegalStateException
- 当前对象已被释放
-
isAllDirectionsOverlappedAvoided
public boolean isAllDirectionsOverlappedAvoided()
设置是否允许以全方向统计专题图避让。通常统计专题图避让是以全方向进行的,虽然避让比较合理,但会影响显示效率;如果提高显示效率,请设置
setAllDirectionsOverlappedAvoided()
方法为 false。全方向即指以统计专题图外边框和基准线而形成的 12 个方向。
四方向是指以统计专题图外边矩形框的四个角点方向。
- 返回:
- 如果全方向统计专题图避让即为 true,如果四方向统计专题图避让为 false。
-
setAllDirectionsOverlapedAvoided
@Deprecated public void setAllDirectionsOverlapedAvoided(boolean value)
已过时。废弃,参见:setAllDirectionsOverlappedAvoided- 参数:
value
-- 抛出:
IllegalStateException
- 当前对象已被释放
-
setAllDirectionsOverlappedAvoided
public void setAllDirectionsOverlappedAvoided(boolean value)
设置是否允许以全方向统计专题图避让。通常统计专题图避让是以全方向进行的,虽然避让比较合理,但会影响显示效率;如果提高显示效率,请设置
setAllDirectionsOverlappedAvoided()
方法为 false。- 参数:
value
- 一个布尔值指定是否以全方向统计专题图避让。
-
fromXML
public boolean fromXML(String xml)
从 XML 字符串中导入专题图信息。在 SuperMap 中,各种专题图的风格的设置都可以导出成 XML 格式的字符串,此 XML 格式的字符串中记录了关于这种专题图的所有设置,如对于标签专题图的 XML 格式字符串会记录专题图类型,可见比例尺,标签风格的设置,是否流动显示,是否自动避让等等对该标签专题图的所有风格的设置以及用来制作标签专题图的字段或表达式。这种 XML 格式字符串可以用来导入,对专题图进行设置。
-
calculateExtremum
public void calculateExtremum()
计算统计专题图各个段的极值- 抛出:
IllegalStateException
- 当前对象已被释放
-
calculateExtremum
public void calculateExtremum(Dataset dataset)
计算统计专题图各个段的极值- 参数:
dataset
- 数据集- 抛出:
IllegalStateException
- 当前对象已被释放
-
setGlobalMaxValueEnabled
public void setGlobalMaxValueEnabled(boolean value)
设置是否使用全局最大值制作统计专题图。true,表示使用全局最大值作为统计图元素的最大值,保证同一专题图层中统计图元素具有一致的刻度。- 参数:
value
- 一个布尔值,指示是否使用全局最大值制作统计专题图。true,表示使用全局最大值作为统计图元素的最大值,保证同一专题图层中统计图元素具有一致的刻度。
-
isGlobalMaxValueEnabled
public boolean isGlobalMaxValueEnabled()
返回是否使用全局最大值制作统计专题图。true,表示使用全局最大值作为统计图元素的最大值,保证同一专题图层中统计图元素具有一致的刻度。- 返回:
- 一个布尔值,指示是否使用全局最大值制作统计专题图。true,表示使用全局最大值作为统计图元素的最大值,保证同一专题图层中统计图元素具有一致的刻度。
-
setValueDigit
public void setValueDigit(int value)
设置显示精度- 参数:
value
- 显示精度- 抛出:
IllegalStateException
- 当前对象已被释放
-
getValueDigit
public int getValueDigit()
获取显示精度(标注格式在使用真实值设置时)- 返回:
- 显示精度
- 抛出:
IllegalStateException
- 当前对象已被释放
-
setDigitAlign
public void setDigitAlign(boolean value)
设置是否补零对齐(标注格式在使用真实值设置时)- 参数:
value
- 是否补零对齐- 抛出:
IllegalStateException
- 当前对象已被释放
-
isDigitAlign
public boolean isDigitAlign()
是否为补零对齐(标注格式在使用真实值设置时)- 返回:
- 是否补零对齐
- 抛出:
IllegalStateException
- 当前对象已被释放
-
setStrUnitYAxirShow
public void setStrUnitYAxirShow(String value)
设置统计专题图Y轴显示单位字符串- 参数:
value
- 需要显示的字符串- 抛出:
IllegalStateException
- 当前对象已被释放
-
getStrUnitYAxirShow
public String getStrUnitYAxirShow()
获取统计专题图Y轴显示单位字符串- 返回:
- 显示的字符串
- 抛出:
IllegalStateException
- 当前对象已被释放
-
-
Copyright © 2021–2024 SuperMap. All rights reserved.