Workspace类参考

工作空间。 更多...

所有成员的列表。

公有成员
(id)	- init
	构造一个新的 Workspace 对象。
(BOOL)	- open:
	用于打开已有的工作空间文件。成功返回 true。
(BOOL)	- save
	保存工作空间
(void)	- close
	关闭工作空间。
(void)	- dispose
	释放该对象所占用的资源。当调用该方法之后，此对象不再可用。
属性
WorkspaceConnectionInfo *	connectionInfo
	获取工作空间的连接信息。
Datasources *	datasources
	返回数据源集合对象。
NSString *	caption
	获取或设置工作空间显示名称，便于用户做一些标识，可以修改。
Maps *	maps
	返回工作空间中的地图集合对象。
Scenes *	scenes
	返回工作空间中的场景集合对象。
Resources *	resources
	返回符号库对象。
NSString *	description
	获取或设置用户加入的对当前工作空间的描述或说明性信息。
BOOL	isModified
	返回工作空间的内容是否有改动，如果对工作空间的内容进行了一些修改，则返回 true，否则返回 false。

---

详细描述

工作空间。

工作空间是用户的工作环境，主要完成数据的组织和管理，包括打开、关闭、创建、保存工作空间文件（SXW,SMW,SXWU,SMWU,DEFAULT）。工作空间（Workspace）是 SuperMap 中的一个重要的概念，工作空间存储了一个工程项目（同一个事务过程）中所有的数据源，地图的组织关系，工作空间通过其中的数据源集合对象（Datasources），地图集合对象（Maps）来管理其下的数据源，地图。

工作空间中的数据源集合 <Datasources> 只存储数据源的连接信息和位置等，实际的数据源都是存储在UDB 中。工作空间中的地图集合 <Maps> 中存储的是地图的一些配置信息，如地图包含图层的个数，图层引用的数据集，地图范围，背景风格等。

在当前版本中，一个应用程序中允许多个工作空间共存，每个工作空间可以管理自己的一套数据源和地图等，但是值得注意的是不同的工作空间是不可以相互操作的。

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

---

成员函数文档

- (void) close

关闭工作空间。

工作空间的关闭之前确保使用的该工作空间的地图等内容关闭或断开链接。

- (void) dispose

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

对数据集进行操作后必须调用 dispose 方法，否则数据修改内容不能被保存。

- (id) init

构造一个新的 Workspace 对象。

- (BOOL) open:

(WorkspaceConnectionInfo *)

info

用于打开已有的工作空间文件。成功返回 true。

打开工作空间时，数据源集合、地图集合都会被读入到内存中。如果其中的数据源被设置为自动连接，则在打开工作空间时就会连接到这些数据源数据，但如果要对数据进行访问，还需要打开数据源下某个具体的数据集；如果数据源没有被设置为自动连接，则只能返回数据源的别名，数据源中存储的数据集信息不可知，数据源中数据也不可用。

当打开工作空间时，如果其中有某几个数据源没有被成功打开，而 open 方法仍然返回 true，可以通过查看日志来获悉哪些数据源未被成功打开。

参数:

info

用来打开工作空间的工作空间连接信息对象。

返回:

一个值指示工作空间是否打开，如果打开成功返回 true，否则返回 false。

- (BOOL) save

保存工作空间

返回:

返回boolean类型，保存成功返回true，否则返回false

异常:

Exception

以下情况会抛出异常： 1.当前工作空间对象已经释放; 2.工作空间是新建的，没有指定保存路径; 3.指定保存文件所在目录不存在，将自动创建目录，但创建失败; 4.指定了保存文件的路径，但文件后缀名不是有效的工作空间类型，且没有指定工作空间类型;

---

属性文档

- (NSString*) caption [read, write, assign]

获取或设置工作空间显示名称，便于用户做一些标识，可以修改。

默认值为 "UntitledWorkspace"。

返回:

工作空间显示名称。

- (WorkspaceConnectionInfo*) connectionInfo [read, assign]

获取工作空间的连接信息。

默认值为 {Name="",Type=SM_DEFAULT,Version=UGC60,Server="",Database="",Driver="",User="",Password=""}。

返回:

工作空间的连接信息。

请参见： <WorkspaceConnectionInfo>

- (Datasources*) datasources [read, assign]

返回数据源集合对象。

数据源集合对象存储工作空间下的数据源的逻辑信息，如数据源数据的连接信息，位置等，并不存储实际的数据源数据。实际的数据源数据存储在关系型数据库或 UDB 文件中。工作空间的数据源集合对象主要用来管理该工作空间中的数据源，包括打开、创建、关闭等操作。

默认值为一个初始化的 <Datasources> 对象。

返回:

数据源集合对象。

- (NSString*) description [read, write, assign]

获取或设置用户加入的对当前工作空间的描述或说明性信息。

默认值为一个空字符串。

返回:

用户加入的对当前工作空间的描述或说明性信息。

- (BOOL) isModified [read, assign]

返回工作空间的内容是否有改动，如果对工作空间的内容进行了一些修改，则返回 true，否则返回 false。

工作空间负责管理数据源、地图，其中任何一项内容发生变动，此属性都会返回 true，在关闭整个应用程序时，先用此属性判断工作空间是否已有改动，可用于提示用户是否需要存盘。

默认值为 false， 即工作空间中的内容没有改动。

返回:

如果对工作空间的内容进行了一些修改，则返回 true，否则返回 false。

- (Maps*) maps [read, assign]

返回工作空间中的地图集合对象。

地图集合对象存储当前工作空间里保存的所有地图，但通过该对象只能访问到地图的名称。如果想打开或者对工作空间下的某个地图进行操作，需要通过 <Map> 对象从此地图集合对象中返回名称，再进行访问。注意 <Map> 对象必须先连接工作空间，才能打开地图。

默认值为一个初始化的 <Maps> 对象。

返回:

工作空间中的地图集合对象。

- (Resources*) resources [read, assign]

返回符号库对象。

符号库对象包含工作空间下所有符号信息，内涵三个子库，即点符号库（MarkerSymbolLiberary）、线符号库（LineSymbolLiberary）和面符号库（FillSymbolLiberary）。

默认值为一个初始化的 <Resources> 对象。

返回:

符号库对象。

- (Scenes*) scenes [read, assign]

返回工作空间中的场景集合对象。

场景集合对象存储当前工作空间里保存的所有场景。

默认值为一个空的Scenes对象。

返回:

工作空间中的场景集合对象。

---

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

• Workspace.h