| 包 | com.supermap.web.iServerJava6R.themeServices |
| 类 | public class ThemeLabel |
| 继承 | ThemeLabel  Theme Object |
标签专题图是用文本的形式在图层中显示点、线、面等对象的属性信息，一般将文本型或数值型字段标注于图层中，如地名、道路名称、河流等级、宽度等信息。这里需要注意的是地图上一般还会出现图例说明，图名，比例尺等等，这些都是制图元素，不属于标签专题图标注的范畴。标签专题图有两种表现形式:
第一种 统一标签专题图，即将指定图层的表达式的所有值使用统一的风格输出，labelExpression 用于设定标签专题图所使用的字段。
第二种 为分段标签专题图。它仍然使用 labelExpression 设定标签专题图显示的字段值，通过 rangeExpression 指定数字型的字段作为分段依据（即使用 rangeExpression 属性分段，使用 labelExpression 属性显示）。items 中的每个子对象的 [start，end] 分段值必须来源于属性 rangeExpression 的字段值，并在 items 中为每个或部分分段子项自定义特殊的风格。
下图为一幅标签专题图的示意图：
| 属性 | 定义方 | ||
|---|---|---|---|
| alongLine : ThemeLabelAlongLine
ThemeLabelAlongLine 对象，用于定义标签沿线标注的样式.
|
ThemeLabel | ||
| background : ThemeLabelBackground
ThemeLabelBackground 对象，标签专题图中标签的背景显示样式。通过该字段可以设置标签的背景形状和颜色等。
|
ThemeLabel | ||
| items : Array
设置分段标签专题图子项（ThemeLabelItem）数组
|
ThemeLabel | ||
| labelEexpression : String
标注字段表达式。系统将 labelExpression 对应的字段或字段表达式的值以标签的形式显示在图层中。必设字段。
|
ThemeLabel | ||
| labelOverLengthMode : String
LabelOverLengthMode 枚举类常量，专题图中超长标签的处理模式，默认为 LabelOverLengthMode.NONE.
|
ThemeLabel | ||
| matrixCells : Array
矩阵标签元素数组.
|
ThemeLabel | ||
| maxLabelLength : Number
标签在每一行显示的最大长度，单位为字符，默认为 256.
|
ThemeLabel | ||
| numericPrecision : int
如果显示的标签内容为数字，通过该字段设置其显示的精度.
|
ThemeLabel | ||
| offset : ThemeOffset
ThemeOffset 对象，用于定义专题图中标签的偏移量。
|
ThemeLabel | ||
| overlapAvoided : Boolean
是否允许以文本避让方式显示文本。默认值为 false， 即不进行自动避让.
|
ThemeLabel | ||
| rangeExpression : String
制作分段标签专题的分段字段或字段表达式.
|
ThemeLabel | ||
| smallGeometryLabeled : Boolean
是否显示长度大于被标注对象本身长度的标签，默认为 false，即不显示.
|
ThemeLabel | ||
| text : ThemeLabelText
ThemeLabelText 对象，标签中的文本风格。
|
ThemeLabel | ||
 |
themeMemoryData : ThemeMemoryData
制作专题图时，如果设置了内存数据，则会制作基于内存数据的专题图。具体实现为：在使用专题值制作专题图后，会用外部值代替专题值来制作相应的专题图。.
|
Theme | |
| 方法 | 定义方 | ||
|---|---|---|---|
|
初始化 ThemeLabel 类的新实例。
|
ThemeLabel | ||
| alongLine | 属性 |
隐藏继承的公共属性
显示继承的公共属性alongLine:ThemeLabelAlongLine
ThemeLabelAlongLine 对象，用于定义标签沿线标注的样式.
沿线标注属性只适用于线数据集专题图。
public function get alongLine():ThemeLabelAlongLine public function set alongLine(value:ThemeLabelAlongLine):void| background | 属性 |
background:ThemeLabelBackground
ThemeLabelBackground 对象，标签专题图中标签的背景显示样式。通过该字段可以设置标签的背景形状和颜色等。
public function get background():ThemeLabelBackground public function set background(value:ThemeLabelBackground):void| items | 属性 |
items:Array
设置分段标签专题图子项（ThemeLabelItem）数组
public function get items():Array public function set items(value:Array):void| labelEexpression | 属性 |
labelEexpression:String
标注字段表达式。系统将 labelExpression 对应的字段或字段表达式的值以标签的形式显示在图层中。必设字段。
public function get labelEexpression():String public function set labelEexpression(value:String):void| labelOverLengthMode | 属性 |
labelOverLengthMode:String
LabelOverLengthMode 枚举类常量，专题图中超长标签的处理模式，默认为 LabelOverLengthMode.NONE.
对于长度超过 maxLabelLength 属性值的标签称为超长标签。
public function get labelOverLengthMode():String public function set labelOverLengthMode(value:String):void另请参见
| matrixCells | 属性 |
matrixCells:Array
矩阵标签元素数组.
该属性是一个二维数组，数组中的每个对象即为一个矩阵标签元素。矩阵标签元素分为三种类型：图片、符号、专题图，可任意组合。如：Themelabel.matrixCells = [new Array(ThemeLabelCell, LabelSymbolCell),new Array(LabelSymbolCell, LabelImageCell)]。
public function get matrixCells():Array public function set matrixCells(value:Array):void另请参见
| maxLabelLength | 属性 |
maxLabelLength:Number
标签在每一行显示的最大长度，单位为字符，默认为 256.
一个中文为两个字符。如果超过最大长度，可以采用两种方式来处理，一种是换行的模式进行显示，另一种是以省略号方式显示。
默认值为： 256.
public function get maxLabelLength():Number public function set maxLabelLength(value:Number):void| numericPrecision | 属性 |
numericPrecision:int
如果显示的标签内容为数字，通过该字段设置其显示的精度.
例如标签对应的数字是8071.64529347，如果该属性为0时，显示8071；为1时，显示8071.6；为3时，则是8071.645。
public function get numericPrecision():int public function set numericPrecision(value:int):void| offset | 属性 |
offset:ThemeOffset
ThemeOffset 对象，用于定义专题图中标签的偏移量。
public function get offset():ThemeOffset public function set offset(value:ThemeOffset):void| overlapAvoided | 属性 |
overlapAvoided:Boolean
是否允许以文本避让方式显示文本。默认值为 false， 即不进行自动避让.
当标签有重叠时，使用该方法可以在一定程度上避免这种现象。
public function get overlapAvoided():Boolean public function set overlapAvoided(value:Boolean):void| rangeExpression | 属性 |
rangeExpression:String
制作分段标签专题的分段字段或字段表达式.
该表达式对应的字段（或者字段表达式）的值应该为数值型。该字段与 items 分段子项联合使用，每个子项的起始值 [start，end)来源于 rangeExpression 字段值。最后 labelExpression 指定的标签字段（标签专题图要显示的具体内容）会根据分段子项的风格进行分段显示。
public function get rangeExpression():String public function set rangeExpression(value:String):void| smallGeometryLabeled | 属性 |
smallGeometryLabeled:Boolean
是否显示长度大于被标注对象本身长度的标签，默认为 false，即不显示.
在标签的长度大于线或者面对象本身的长度时，如果该值为 true，则标签文字会叠加在一起显示，为了清楚完整的显示该标签，可以采用换行模式（LabelOverLengthMode.NEWLINE）来显示标签，但必须保证每行的长度小于对象本身的长度。
public function get smallGeometryLabeled():Boolean public function set smallGeometryLabeled(value:Boolean):void另请参见
| text | 属性 |
text:ThemeLabelText
ThemeLabelText 对象，标签中的文本风格。
public function get text():ThemeLabelText public function set text(value:ThemeLabelText):void| ThemeLabel | () | 构造函数 |
public function ThemeLabel()
初始化 ThemeLabel 类的新实例。