MapGuide预定义了许多命令用于提供一些常用的功能,例如平移地图、缩放地图、打印地图、选择要素、测量距离、创建缓冲区等。对于大部分预定义命令,我们只能直接使用它们,或者修改它们的显示名称、工具提示、显示在状态栏上的描述信息、图标等。

下面我们以添加“Help”命令添加到工具栏为例,介绍如何使用预定义命令。

1) 创建帮助文档。

假设我们创建了如下的帮助文档“index.html”,将其保存在目录“<WebExInstallDir>/help”下。

<html>

<head>

<meta http-equiv="Content-Type" content="text/html; charset=utf-8">

<title>My Help Document</title>

</head>

My Help Document.

</html>

 

2) 基于预定义的“Help”命令创建新的命令“My Help”。

首先,打开基本Web布局编辑器,点击头部的超链接“New Commands”跳转到“New Commands”面板。然后,点击“New Commands”面板中的下拉按钮“Add -> Built-In Command -> Help”基于预定义的“Help”命令创建新的命令“My Help”。最后,在“Additional Parameters”标签页中设置参数“URL for help page to launch”为文件“../help/index.html”。

如果希望帮助文档显示在Viewer的“任务面板中”,那么保持参数“Disaplay returns in this target interface”的值为“Task pane”不变;如果希望在一个新的浏览器窗口中显示帮助文档,那么将参数“Disaplay returns in this target interface”的值修改为“New window”不变。

Command Window

4‑3 基于预定义的“Help”命令创建新的命令“My Help”

3) 将命令“My Help”添加到工具栏。

首先,点击基本Web布局编辑器头部的超链接“Toolbar and Menus”打开“Toolbar and Menus”面板。接着,将右面命令列表中的“My Help”命令拖拽到左面的工具栏树形列表中。

4) 保存修改后的Web布局。

保存修改的Web布局后,拷贝“Setting”面板中“Preview in browser using DWF Viewer”文本框或“Preview in browser using AJAX Viewer”文本框中的URL到浏览器的地址栏中,就可以测试“My Help”命令了。点击“My Help”按钮,运行效果如图4‑4所示,可以看到我们创建的帮助文档显示在了任务面板中。

Help Window

4‑4 “My Help”命令的运行效果

在图 4‑3中,我们可以看到MapGuide Studio将“My Help”命令归类为自定义(Custom)命令,而不是预定义(Built-In)命令,因为我们为命令“My Help”设置了一些额外的参数值。但是,对于像“Help”这样的预定义命令,如果不设置帮助文档的URL,直接使用它们没有任何意义,所以我更愿意将基于预定义命令创建的命令归类为预定义命令。

posted on 2013-03-29 17:10  GIS_小强  阅读(167)  评论(0编辑  收藏  举报