MapControl类参考

地图控件类。 更多...

所有成员的列表。

公有成员
(id)	- init
	默认构造函数，构造一个新的MapControl对象。
(id)	- initWithFrame:
	根据指定的CGRect（尺寸）构造一个新的MapControl对象。
(id)	- initWithWorkspace:
	构造一个新的MapControl对象，并将其中Map对象关联到指定的工作空间。
(void)	- mapControlInit
	初始化MapControl的新实例，无返回值。
(void)	- enableRotateTouch:
(void)	- enableSlantTouch:
(void)	- setSizeWithHeight:Width:
	设置用户的宽度和高度。
(void)	- addDynamicView:
	添加动态层。
(void)	- removeDynamivView:
	删除动态层。
(void)	- removeCalloutAtIndex:
	从Mapcontrol上移除指定序号的Callout对象。
(void)	- removeCalloutWithArr:
	从Mapcontrol上移除calloutArr内的callout。
(void)	- removeAllCallouts
	移除 Mapcontrol上所有Callout对象。
(int)	- getCalloutCount
	获取MapControl上Callout对象的个数。
(void)	- dispose
	释放对象所占用的资源。调用该方法之后，此对象不再可用。
(void)	- undo
	地图控件上撤消上一次的操作。
(void)	- redo
	地图窗口上恢复上一步的操作。恢复操作必须以撤销操作为前提。
(Geometry *)	- getCurrentGeometry
	获取当前的编辑对象。
(BOOL)	- submit
	地图窗口上提交编辑绘制对象。提交对象操作必须以地图编辑为前提。
(void)	- cancel
	取消当前的操作。
(void)	- deleteCurrentGeometry
	地图窗口上删除编辑对象操作。删除对象操作必须以地图编辑且地图上有选中的编辑对象为前提。
(Navigation *)	- getNavigation
	获取导航模块。
(Navigation2 *)	- getNavigation2
(Navigation3 *)	- getNavigation3
(CGImageRef)	- outputMap:
	将当前显示内容绘制到指定位图上
(BOOL)	- onSelectX:Y:
	选择事件
(BOOL)	- appointEditGeometryWithID:Layer:
	指定编辑对象
(Collector *)	- getCollector
	获取GPS采集对象
(void)	- zoomTo:time:
	在指定的时间内到指定的比例尺
(void)	- panTo:time:
	在指定的时间内平移到指定的点
(void)	- cancelAnimation
	取消平移和缩放的动画
(int)	- addPlotLibrary:
(void)	- removePlotLibrary:
(void)	- setPlotSymbol:symbolCode:
属性
Map *	map
	获取在地图控件中显示的地图对象。
Action	action
	获取或设置地图控件中地图的当前操作状态。在 Action 类中定义了目前支持的所有的对地图的操作模式。
double	selectionTolerance
	获取或设置选择空间对象的容限。
SelectionMode	selectionMode
	获取或设置对象的选择模式。
NSInteger	mapHeight
	获取用户设置的控件高度。
NSInteger	mapWidth
	关联动态层。
double	strokeWidth
	绘制对象画笔宽度。
Color *	strokeColor
	绘制对象画笔颜色。
Color *	strokeFillColor
	绘制对象填充颜色。
double	nodeSize
	绘制对象节点大小。
Color *	nodeColor
	获取或设置绘制对象时节点颜色。
GeoStyle *	nodeStyle
	获取或设置绘制对象时节点几何风格
NSMutableArray *	callouts
	获取当前MapControl中存储的Callout对象集合。
id< TouchableViewDelegate >	delegate
	用户的手势回调。
id< MapEditDelegate >	mapEditdelegate
	编辑地图时用户回调。
id< MapMeasureDelegate >	mapMeasureDelegate
	地图量算时通知委托。
id< GeometrySelectedDelegate >	geometrySelectedDelegate
	几何对象选中时通知委托。
id< AfterGeometryAddedDelegate >	geometryAddedDelegate
	几何对象添加时通知委托。
id< AfterGeometryModifiedDelegate >	geometryModifiedDelegate
	几何对象修改时通知委托。
id< AfterGeometryDeletedDelegate >	geometryDeletedDelegate
	几何对象删除时通知委托。
BOOL	isMagnifierEnabled
	获取或设置一个布尔值指定当前地图是否启用放大镜功能，默认不启动。。
int	magnifierRadius
CGRect	rect
SnapSetting *	snapSetting
	设置,获取 地图控件的捕捉设置

---

详细描述

地图控件类。

该类是用于为地图的显示提供界面的，同时为地图与数据的互操作提供了途径。

地图控件是一个对地图进行显示的控件。通过地图控件，不仅可以对地图进行显示，而且可以通过对地图的可视化编辑，从而对地图所引用的数据进行编辑。

当一个地图对象与一个地图控件相关联，该地图控件即可以对该地图对象进行显示，地图的显示属性以及显示操作都将在该地图对象中设置。然而对地图的可视化编辑的设置和操作将在 MapControl 对象中设置。

注意：

当用户使用该工作空间对象进行编程时，如果将 Workspace 与 MapControl 建立了关联，那么在进行对象的关闭时，一定需要注意关闭的顺序，如下： 1. 关闭 Map 对象； 2. 关闭 MapControl 对象； 3. 关闭 Workspace 对象。

---

成员函数文档

- (void) addDynamicView:

(DynamicView *)

dyView

添加动态层。

- (int) addPlotLibrary:

(NSString *)

libraryPath

- (BOOL) appointEditGeometryWithID:		(int)	ID
Layer:		(Layer *)	layer

指定编辑对象

参数:

	geomety	要编辑的对象
	layer	要编辑对象所属的图层

返回:

- (void) cancel

取消当前的操作。

返回:

- (void) cancelAnimation

取消平移和缩放的动画

返回:

- (void) deleteCurrentGeometry

地图窗口上删除编辑对象操作。删除对象操作必须以地图编辑且地图上有选中的编辑对象为前提。

- (void) dispose

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

- (void) enableRotateTouch:

(BOOL)

value

- (void) enableSlantTouch:

(BOOL)

value

- (int) getCalloutCount

获取MapControl上Callout对象的个数。

- (Collector*) getCollector

获取GPS采集对象

- (Geometry*) getCurrentGeometry

获取当前的编辑对象。

返回:

- (Navigation *) getNavigation

获取导航模块。

- (Navigation2 *) getNavigation2

- (Navigation3 *) getNavigation3

- (id) init

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

- (id) initWithFrame:

(CGRect)

frame

根据指定的CGRect（尺寸）构造一个新的MapControl对象。

参数:

frame

指定的CGRect（尺寸）。

- (id) initWithWorkspace:

(Workspace *)

workspace

构造一个新的MapControl对象，并将其中Map对象关联到指定的工作空间。

参数:

workspace

指定的工作空间。

- (void) mapControlInit

初始化MapControl的新实例，无返回值。

- (BOOL) onSelectX:		(int)	x
Y:		(int)	y

选择事件

参数:

	x	选择点的x坐标
	y	选择点的y坐标

返回:

是否选择成功,选上对象返回true,未选中返回false

- (CGImageRef) outputMap:

(CGRect)

rect

将当前显示内容绘制到指定位图上

参数:

image

需要被绘制的位图

返回:

- (void) panTo:		(Point2D *)	ptnDest
time:		(int)	time

在指定的时间内平移到指定的点

参数:

	ptnDest	目标点
	time	持续时间

返回:

- (void) redo

地图窗口上恢复上一步的操作。恢复操作必须以撤销操作为前提。

返回:

成功完成恢复操作返回 true；否则返回 false。

- (void) removeAllCallouts

移除 Mapcontrol上所有Callout对象。

- (void) removeCalloutAtIndex:

(int)

index

从Mapcontrol上移除指定序号的Callout对象。

参数:

index

指定的 Callout 对象的索引。

- (void) removeCalloutWithArr:

(NSArray *)

calloutArr

从Mapcontrol上移除calloutArr内的callout。

参数:

callout数组

- (void) removeDynamivView:

(DynamicView *)

dyView

删除动态层。

- (void) removePlotLibrary:

(int)

libraryID

- (void) setPlotSymbol:		(int)	libraryID
symbolCode:		(long)	symbolCode

- (void) setSizeWithHeight:		(NSInteger)	height
Width:		(NSInteger)	width

设置用户的宽度和高度。

参数:

	width	设置高度。
	height	设置宽度 。

- (BOOL) submit

地图窗口上提交编辑绘制对象。提交对象操作必须以地图编辑为前提。

- (void) undo

地图控件上撤消上一次的操作。

返回:

成功完成撤销操作返回 true；否则返回 false。

- (void) zoomTo:		(double)	scaleDest
time:		(int)	time

在指定的时间内到指定的比例尺

参数:

	scaleDest	目标比例尺
	time	持续时间

返回:

---

属性文档

- (Action) action [read, write, assign]

获取或设置地图控件中地图的当前操作状态。在 Action 类中定义了目前支持的所有的对地图的操作模式。

返回:

地图控件中地图的当前操作状态。

默认值为NULL。

异常:

EnumConstantNotPresentException

当取出的值错误时。

- (NSMutableArray*) callouts [read, write, retain]

获取当前MapControl中存储的Callout对象集合。

- (id<TouchableViewDelegate>) delegate [read, write, assign]

用户的手势回调。

- (id<AfterGeometryAddedDelegate>) geometryAddedDelegate [read, write, assign]

几何对象添加时通知委托。

- (id<AfterGeometryDeletedDelegate>) geometryDeletedDelegate [read, write, assign]

几何对象删除时通知委托。

- (id<AfterGeometryModifiedDelegate>) geometryModifiedDelegate [read, write, assign]

几何对象修改时通知委托。

- (id<GeometrySelectedDelegate>) geometrySelectedDelegate [read, write, assign]

几何对象选中时通知委托。

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

获取或设置一个布尔值指定当前地图是否启用放大镜功能，默认不启动。。

- (int) magnifierRadius [read, write, assign]

- (Map*) map [read, write, retain]

获取在地图控件中显示的地图对象。

默认值为空的Map对象

返回:

在地图控件中显示的地图对象。

- (id<MapEditDelegate>) mapEditdelegate [read, write, assign]

编辑地图时用户回调。

- (NSInteger) mapHeight [read, assign]

获取用户设置的控件高度。

返回:

控件高度。

- (id<MapMeasureDelegate>) mapMeasureDelegate [read, write, assign]

地图量算时通知委托。

- (NSInteger) mapWidth [read, assign]

关联动态层。

- (Color*) nodeColor [read, write, retain]

获取或设置绘制对象时节点颜色。

- (double) nodeSize [read, write, assign]

绘制对象节点大小。

返回:

绘制对象节点大小。

- (GeoStyle*) nodeStyle [read, write, retain]

获取或设置绘制对象时节点几何风格

- (CGRect) rect [read, write, assign]

- (SelectionMode) selectionMode [read, write, assign]

获取或设置对象的选择模式。

参见 SelectionMode 常量。针对除点选之外的区域选择方式。

默认的对象选择模式为 SelectionMode.CONTAIN_INNER_POINT，即对象的内点在选择范围内的就选中。

返回:

对象的选择模式。

- (double) selectionTolerance [read, write, assign]

获取或设置选择空间对象的容限。

即要素上距离鼠标指针最近点到鼠标指针的距离在多大范围以内，可以认为该空间对象被选中，单位为毫米，精确到 0.1 毫米。针对点选方式。

默认值为 1。

返回:

选择空间对象的容限。

- (SnapSetting*) snapSetting [read, write, assign]

设置,获取 地图控件的捕捉设置

参数:

value

- (Color*) strokeColor [read, write, retain]

绘制对象画笔颜色。

返回:

绘制对象画笔颜色。

- (Color*) strokeFillColor [read, write, retain]

绘制对象填充颜色。

返回:

绘制对象填充颜色。

- (double) strokeWidth [read, write, assign]

绘制对象画笔宽度。

返回:

绘制对象画笔宽度。

---

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

• MapControl.h