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