TrackingLayer类参考

跟踪图层类。 更多...

所有成员的列表。

公有成员

(BOOL) - isSymbolScalable
 返回跟踪图层的符号大小是否随图缩放。
(void) - setAsyncRefresh:
 在当前跟踪图层是否实时渲染。
(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:
 添加字段的显示风格 每一个风格对应一个显示字段
(BOOL) - createUserFieldDouble:size:attribute:
 创建double型字段
(BOOL) - createUserFieldInt:size:attribute:
 创建int型字段
(BOOL) - createUserFieldString:size:attribute:
 创建string型字段
(void) - deleteAllFeatures
 删除所有对象(保留表结构)
(BOOL) - deleteUserField:
 删除指定字段
(int) - getEvent:
 获取GeoEvent
(double) - getFieldDouble:fieldName:
 获取跟踪图层中指定的ID的指定字段名称的的double型的字段的值。
(FieldInfo *) - getFieldInfo:
 获取跟踪图层中指定字段名称的字段信息。
(FieldInfos *) - getFieldInfos
 获取字段信息
(int) - getFieldInt:fieldName:
 获取跟踪图层中指定的ID的指定字段名称的的int型的字段的值。
(NSString *) - getFieldName:
 获取字段名
(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 

添加字段的显示风格 每一个风格对应一个显示字段

参数:
tag 对应的字段名称
style 文本风格
visible 是否可见
tail true是加到末尾，false是加到开头
- (void) clear  

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

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

创建double型字段

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

创建int型字段

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

创建string型字段

- (void) deleteAllFeatures  

删除所有对象(保留表结构)

- (BOOL) deleteUserField: (NSString *)  fieldName  

删除指定字段

- (void) flushBuck  

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

- (Geometry *) getAt: (int)  index  

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

参数:
index 要返回的几何对象的ID。
返回:
指定ID的几何对象。
- (int) getEvent: (NSString *)  tag  

获取GeoEvent

参数:
tag 几何对象的标签名称[in]
返回:
返回几何对象的ID
- (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型的字段的值。

参数:
findex 指定的ID。
fieldname 指定字段的名称。
- (NSString *) getFieldName: (int)  index  

获取字段名

- (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  

将指定标签移动到底部

- (BOOL) labelMoveDown: (NSString *)  tag  

将指定标签的显示下移

- (BOOL) labelMoveTop: (NSString *)  tag  

将指定标签移动到顶部

- (BOOL) labelMoveUp: (NSString *)  tag  

将指定标签上移

- (BOOL) removeAt: (int)  index  

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

参数:
index 要删除的几何对象的ID。
返回:
删除成功返回 true；否则返回 false。
- (BOOL) removeLabel: (NSString *)  fieldName  

移除字段的显示风格

参数:
字段名 
- (void) setAsyncRefresh: (BOOL)  isAsync  

在当前跟踪图层是否实时渲染。

参数:
isAsync 布尔值，true为开启，false为不开启
- (void) setEditBuck: (BOOL)  isEditBuck  

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

参数:
isEditBuck 布尔值，true为开启，false为不开启。
返回:
isEditBuck 的值为true时则返回 true；否则返回 false。
- (BOOL) setFieldDouble: (NSString *)  fieldName
fieldValue: (double)  fieldValue 

设置double类型的值

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

设置指定记录指定字段的double类型的值

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

设置int类型的值

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

设置指定记录指定字段的int类型的值

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

设置string类型的值

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

设置指定记录指定字段的string类型的值

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

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

参数:
geometry 用来替换的新 Geometry 对象。
index 要替换几何对象的索引。
返回:
替换成功返回 true；否则返回 false。
- (BOOL) setLabelCaption: (NSString *)  tag
caption: (NSString *)  caption 

设置标签对应的字段

参数:
tag 目前对应的字段
Caption 修改后的字段
- (BOOL) setLabelOffset: (NSString *)  tag
x: (short)  x
y: (short)  y 

设置字段文本的偏移

参数:
tag 字段名
x x方向偏移
y y方向偏移
- (BOOL) setLabelTextStyle: (NSString *)  tag
textStyle: (TextStyle *)  textStyle 

设置标签的文本风格

style 文本风格

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

设置风格是否可见

参数:
tag 字段名
visible 是否可见
- (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。

返回:
一个布尔值指示此图层是否可见。
该类的文档由以下文件生成：
版权所有©2005-2021 北京超图软件股份有限公司。保留所有权利。