跟踪图层类。更多...

公有成员
(BOOL)	- isSymbolScalable
	返回跟踪图层的符号大小是否随图缩放。
(int)	- addGeometry:WithTag:
	向当前跟踪图层中添加一个几何对象，并给出该几何对象的标签信息。
(BOOL)	- removeAt:
	在当前跟踪图层中删除指定ID的几何对象。
(Geometry *)	- getAt:
	返回此跟踪图层中指定索引的几何对象。
(BOOL)	- setGeometry:At:
	将跟踪图层中的指定的索引处的几何对象替换为指定的几何对象，若此索引处原先有其他几何对象，则会被删除。
(NSString *)	- getTagAt:
	返回此跟踪图层中指定ID的几何对象的标签信息。
(BOOL)	- setTag:At:
	设置此跟踪图层中指定ID的几何对象的标签信息。
(int)	- indexof:
	返回第一个与指定标签信息相同的几何对象的ID。
(void)	- clear
	清空此跟踪图层中的所有几何对象。
(int)	- hitTest:Tolerance:
	返回满足条件的几何对象的 ID。
(void)	- setEditBuck:
	在当前跟踪图层中开启批量更新。
(void)	- flushBuck
	对跟踪图层进行批量更新。
(BOOL)	- addLabel:textStyle:visible:tail:
	添加字段的显示风格,每一个风格对应一个显示字段 param tag 对应的字段名称 param style 文本风格 param visible 是否可见 param tail true是加到末尾，false是加到开头
(BOOL)	- createUserFieldDouble:size:attribute:
	向当前跟踪图层中创建字段类型为double型的用户字段信息。
(BOOL)	- createUserFieldInt:size:attribute:
	向当前跟踪图层中创建字段类型为int型的用户字段信息
(BOOL)	- createUserFieldString:size:attribute:
	向当前跟踪图层中创建字段类型为String型的用户字段信息。
(void)	- deleteAllFeatures
	删除跟踪图层字段的所有属性信息，包含跟踪层中的几何对象及字段信息的值，属性表结构仍存在。
(BOOL)	- deleteUserField:
	删除跟踪图层指定名称的字段。
(int)	- getEvent:
	获取跟踪图层中指定标签的几何对象的索引。
(double)	- getFieldDouble:fieldName:
	获取跟踪图层中指定的ID的指定字段名称的的double型的字段的值。
(FieldInfo *)	- getFieldInfo:
	获取跟踪图层中指定字段名称的字段信息。
(FieldInfos *)	- getFieldInfos
	获取跟踪图层的字段信息集合。
(int)	- getFieldInt:fieldName:
	获取跟踪图层中指定的ID的指定字段名称的的int型的字段的值。
(NSString *)	- getFieldName:
	获取跟踪图层中用户创建的字段的指定ID的字段名称。
(NSString *)	- getFieldString:fieldName:
	获取跟踪图层中指定的ID的指定字段名称的的String型的字段的值
(BOOL)	- labelMoveBottom:
	将跟踪图层显示的指定名称的字段值移动到底部。
(BOOL)	- labelMoveDown:
	将跟踪图层显示的指定名称的字段值下移一层
(BOOL)	- labelMoveTop:
	将跟踪图层显示的指定名称的字段值移动到顶部。
(BOOL)	- labelMoveUp:
	将跟踪图层显示的指定名称的字段值上移一层。
(BOOL)	- removeLabel:
	将前跟踪图层中显示的字段值移除。
(BOOL)	- setFieldDouble:fieldValue:
	设置此跟踪图层中最新添加的点对象的指定名称字段的Double类型的值。
(BOOL)	- setFieldDoubleEx:fieldValue:index:
	设置此跟踪图层指定记录的指定字段的double类型的值。
(BOOL)	- setFieldInt:fieldValue:
	设置此跟踪图层中最新添加的点对象的指定名称字段的int类型的值。
(BOOL)	- setFieldIntEx:fieldValue:index:
	设置此跟踪图层指定记录的指定字段的int类型的值。
(BOOL)	- setFieldString:fieldValue:
	设置此跟踪图层中最新添加的点对象的指定名称字段的String类型的值
(BOOL)	- setFieldStringEx:fieldValue:index:
	设置此跟踪图层指定记录的指定字段的String类型的值。
(BOOL)	- setLabelCaption:caption:
	设置此跟踪图层指定名称的标签的别名。
(BOOL)	- setLabelOffset:x:y:
	设置此跟踪图层指定名称的字段标签偏移指定的量。
(BOOL)	- setLabelTextStyle:textStyle:
	设置此跟踪图层指定名称的字段标签的文本风格为指定的风格。
(BOOL)	- setLabelVisible:visible:
	设置此跟踪图层指定名称的字段标签是否可见。
(void)	- setSymbolOffset:y:
	设置此跟踪图层几何对象的符号偏移指定的量。
属性
int	count
	返回当前跟踪图层的几何对象的个数。
BOOL	visible
	获取或设置此跟踪图层是否可见。

详细描述

跟踪图层类。

在 SuperMap 中，每个地图窗口都有一个跟踪图层，确切地说，每个地图显示时都有一个跟踪图层。跟踪图层是一个空白的透明图层，总是在地图各图层的最上层，主要用于在一个处理或分析过程中，临时存放一些图形对象，以及一些文本等。只要地图显示，跟踪图层就会存在，不可以删除跟踪图层，也不可以改变其位置。

在 SuperMap iMobile中跟踪图层的作用主要有以下方面： 1. 当不想往记录集中添加几何对象，而又需要这个几何对象的时候，就可以把这个几何对象临时添加到跟踪图层上，用完该几何对象之后清除跟踪图层即可。例如，当需要测量距离时，需要在地图上拉一条线，但是这一条线在地图上并不存在，此时就可以使用跟踪图层来实现。 2. 当需要对目标进行动态跟踪的时候，如果把目标放到记录集中，要实现动态跟踪就得不断地刷新整个图层，这样会大大影响效率，如果将这个需要进行跟踪地目标放到跟踪层上，这样就只需要刷新跟踪图层即可实现动态跟踪。 3. 当需要进行批量地往记录集中添加几何对象的时候，可以先将这些对象临时放在跟踪图层上，确定需要添加之后再把跟踪图层上的几何对象批量地添加到记录集中。

注意：

请注意避免把跟踪图层作为存储大量临时几何对象的容器，如果有大量的临时数据，建议在本地计算机临时目录下（如：c:\temp）创建临时数据源，并在临时数据源中创建相应的临时数据集来保存临时数据。

可以对跟踪图层进行控制，包括控制跟踪图层是否可显示以及符号是否随图缩放。跟普通图层不同的是，跟踪图层中的对象是不保存的，只是在地图显示时，临时存在内存中。当地图关闭后，跟踪图层中的对象依然存在，相应内存释放掉才会消失，当地图再次被打开后，跟踪图层又显示为一个空白而且透明的图层。

该类提供了对跟踪图层上的几何对象进行添加，删除等管理的方法。并且可以通过设置标签的方式对跟踪图层上的几何对象进行分类，可以将标签理解为对几何对象的描述，相同用途的几何对象可以具有相同的标签。

成员函数文档

- (int) addGeometry:	(Geometry *)	geometry
WithTag:	(NSString *)	tag

向当前跟踪图层中添加一个几何对象，并给出该几何对象的标签信息。

参数:

	geometry	要添加的几何对象。
	tag	要添加的几何对象的标签信息。

返回:: 添加到跟踪图层的几何对象的索引，即该几何对象的ID。

- (BOOL) addLabel:	(NSString *)	tag
textStyle:	(TextStyle *)	textStyle
visible:	(BOOL)	visible
tail:	(BOOL)	tail

添加字段的显示风格,每一个风格对应一个显示字段 param tag 对应的字段名称 param style 文本风格 param visible 是否可见 param tail true是加到末尾，false是加到开头

- (void) clear

清空此跟踪图层中的所有几何对象。

- (BOOL) createUserFieldDouble:	(NSString *)	fieldName
size:	(int)	size
attribute:	(int)	attribute

向当前跟踪图层中创建字段类型为double型的用户字段信息。

参数:

	name	创建字段的名称。
	size	创建字段的长度。
	attr	创建字段属性，默认值为0。

- (BOOL) createUserFieldInt:	(NSString *)	fieldName
size:	(int)	size
attribute:	(int)	attribute

向当前跟踪图层中创建字段类型为int型的用户字段信息

参数:

	name	创建字段的名称。
	size	创建字段的长度。
	attr	创建字段属性，默认值为0

- (BOOL) createUserFieldString:	(NSString *)	fieldName
size:	(int)	size
attribute:	(int)	attribute

向当前跟踪图层中创建字段类型为String型的用户字段信息。

参数:

	name	创建字段的名称。
	size	创建字段的长度。
	attr	创建字段属性，默认值为0

- (void) deleteAllFeatures

删除跟踪图层字段的所有属性信息，包含跟踪层中的几何对象及字段信息的值，属性表结构仍存在。

- (BOOL) deleteUserField: (NSString *) fieldName

删除跟踪图层指定名称的字段。

参数:

fieldname

即将要删除的字段的名称。

- (void) flushBuck

对跟踪图层进行批量更新。

- (Geometry *) getAt: (int) index

返回此跟踪图层中指定索引的几何对象。

参数:

index

要返回的几何对象的ID。

返回:: 指定ID的几何对象。

- (int) getEvent: (NSString *) tag

获取跟踪图层中指定标签的几何对象的索引。

参数:

tag

几何对象的标签。

- (double) getFieldDouble:	(int)	index
fieldName:	(NSString *)	fieldName

获取跟踪图层中指定的ID的指定字段名称的的double型的字段的值。

参数:

	index	指定的ID。
	fieldname	指定字段的名称。

- (FieldInfo *) getFieldInfo: (NSString *) fieldName

获取跟踪图层中指定字段名称的字段信息。

参数:

fieldname

指定字段的名称。

- (FieldInfos *) getFieldInfos

获取跟踪图层的字段信息集合。

- (int) getFieldInt:	(int)	index
fieldName:	(NSString *)	fieldName

获取跟踪图层中指定的ID的指定字段名称的的int型的字段的值。

参数:

	index	指定的ID。
	fieldname	指定字段的名称。

- (NSString *) getFieldName: (int) index

获取跟踪图层中用户创建的字段的指定ID的字段名称。

参数:

index

- 用户创建字段的ID

- (NSString *) getFieldString:	(int)	index
fieldName:	(NSString *)	fieldName

获取跟踪图层中指定的ID的指定字段名称的的String型的字段的值

参数:

	index	指定的ID。
	fieldname	指定字段的名称。

- (NSString *) getTagAt: (int) index

返回此跟踪图层中指定ID的几何对象的标签信息。

参数:

index

要返回标签的几何对象的索引。

返回:: 此跟踪图层中指定索引的几何对象的标签。

- (int) hitTest:	(Point2D *)	point
Tolerance:	(double)	tolerance

返回满足条件的几何对象的 ID。

若指定的点与几何对象上最近点的距离是在指定容限范围的范围内，则该几何对象的 ID 被返回。

如果跟踪图层中没有符合条件的几何对象，则返回 -1；

如果地图上有多个重叠的几何对象都满足条件，则返回最上面的几何对象的 ID。

参数:

	point	要测试的点，为地理坐标点。
	tolerance	指定的容限，为地理长度。

返回:: 几何对象的 ID号。

- (int) indexof: (NSString *) tag

返回第一个与指定标签信息相同的几何对象的ID。

参数:

tag

需要进行索引检查的标签信息。

返回:: 第一个与指定标签信息相同的几何对象的ID。

- (BOOL) isSymbolScalable

返回跟踪图层的符号大小是否随图缩放。

true 表示当随着地图的缩放而缩放，在地图放大的同时，符号同时也放大。

默认值为 false。

返回:: 一个布尔值指示跟踪图层的符号大小是否随图缩放。

- (BOOL) labelMoveBottom: (NSString *) tag

将跟踪图层显示的指定名称的字段值移动到底部。

参数:

tag

指定标签的名称。

- (BOOL) labelMoveDown: (NSString *) tag

将跟踪图层显示的指定名称的字段值下移一层

参数:

tag

指定标签的名称。

- (BOOL) labelMoveTop: (NSString *) tag

将跟踪图层显示的指定名称的字段值移动到顶部。

参数:

tag

指定标签的名称。

- (BOOL) labelMoveUp: (NSString *) tag

将跟踪图层显示的指定名称的字段值上移一层。

参数:

tag

指定标签的名称。

- (BOOL) removeAt: (int) index

在当前跟踪图层中删除指定ID的几何对象。

参数:

index

要删除的几何对象的ID。

返回:: 删除成功返回 true；否则返回 false。

- (BOOL) removeLabel: (NSString *) fieldName

将前跟踪图层中显示的字段值移除。

参数:

fieldname

- 要删除的字段值的字段名称。

- (void) setEditBuck: (BOOL) isEditBuck

在当前跟踪图层中开启批量更新。

参数:

isEditBuck

布尔值，true为开启，false为不开启。

返回:: isEditBuck 的值为true时则返回 true；否则返回 false。

- (BOOL) setFieldDouble:	(NSString *)	fieldName
fieldValue:	(double)	fieldValue

设置此跟踪图层中最新添加的点对象的指定名称字段的Double类型的值。

参数:

	fieldname	指定字段的名称。
	fieldValue	指定字段的值。

返回:: 设置成功则返回 true；否则返回 false。

- (BOOL) setFieldDoubleEx:	(NSString *)	fieldName
fieldValue:	(double)	fieldValue
index:	(int)	index

设置此跟踪图层指定记录的指定字段的double类型的值。

参数:

	fieldname	指定字段的名称。
	fieldValue	指定字段的值。
	index	指定ID。

- (BOOL) setFieldInt:	(NSString *)	fieldName
fieldValue:	(int)	fieldValue

设置此跟踪图层中最新添加的点对象的指定名称字段的int类型的值。

参数:

	fieldname	指定字段的名称。
	fieldValue	指定字段的值。

- (BOOL) setFieldIntEx:	(NSString *)	fieldName
fieldValue:	(int)	fieldValue
index:	(int)	index

设置此跟踪图层指定记录的指定字段的int类型的值。

参数:

	fieldname	指定字段的名称。
	fieldValue	指定字段的值。
	index	指定ID。

- (BOOL) setFieldString:	(NSString *)	fieldName
fieldValue:	(NSString *)	fieldValue

设置此跟踪图层中最新添加的点对象的指定名称字段的String类型的值

参数:

	fieldname	指定字段的名称。
	fieldValue	指定字段的值。

- (BOOL) setFieldStringEx:	(NSString *)	fieldName
fieldValue:	(NSString *)	fieldValue
index:	(int)	index

设置此跟踪图层指定记录的指定字段的String类型的值。

参数:

	fieldname	指定字段的名称。
	fieldValue	指定字段的值。
	index	指定ID

- (BOOL) setGeometry:	(Geometry *)	geometry
At:	(int)	index

将跟踪图层中的指定的索引处的几何对象替换为指定的几何对象，若此索引处原先有其他几何对象，则会被删除。

参数:

	geometry	用来替换的新 Geometry 对象。
	index	要替换几何对象的索引。

返回:: 替换成功返回 true；否则返回 false。

- (BOOL) setLabelCaption:	(NSString *)	tag
caption:	(NSString *)	caption

设置此跟踪图层指定名称的标签的别名。

参数:

	fieldname	指定字段的名称。
	caption	修改后的标签的别名。

- (BOOL) setLabelOffset:	(NSString *)	tag
x:	(short)	x
y:	(short)	y

设置此跟踪图层指定名称的字段标签偏移指定的量。

参数:

	fieldname	指定字段的名称。
	x	x方向偏移的量，单位和地图单位一致。
	y	y方向偏移的量，单位和地图单位一致

- (BOOL) setLabelTextStyle:	(NSString *)	tag
textStyle:	(TextStyle *)	textStyle

设置此跟踪图层指定名称的字段标签的文本风格为指定的风格。

参数:

	fieldname	指定字段的名称。
	style	指定的文本风格。

- (BOOL) setLabelVisible:	(NSString *)	tag
visible:	(BOOL)	visible

设置此跟踪图层指定名称的字段标签是否可见。

参数:

	fieldname	指定字段的名称。
	visible	布尔值，值为true是可见，false为不可见。

- (void) setSymbolOffset:	(short)	x
y:	(short)	y

设置此跟踪图层几何对象的符号偏移指定的量。

参数:

	x	x方向偏移的量。
	y	y方向偏移的量。

- (BOOL) setTag:	(NSString *)	tag
At:	(int)	index

设置此跟踪图层中指定ID的几何对象的标签信息。

参数:

	tag	几何对象的新标签信息。
	index	要设置标签的几何对象的索引。

返回:: 设置成功返回 true；否则返回 false。

属性文档

- (int) count [read, assign]

返回当前跟踪图层的几何对象的个数。

默认值为 0。

返回:: 当前跟踪图层的几何对象的个数。

- (BOOL) visible [read, write, assign]

获取或设置此跟踪图层是否可见。

true 表示此跟踪图层可见，false 表示此跟踪图层不可见。当此跟踪图层不可见时，其他的设置都将无效。

默认值为 true。

返回:: 一个布尔值指示此图层是否可见。

该类的文档由以下文件生成：

TrackingLayer.h

TrackingLayer类参考

公有成员

属性

详细描述

成员函数文档

属性文档