程序应用界面的最左上角的按钮为“文件”按钮,点击“文件”按钮后会弹出文件菜单。在文件菜单上可以放置 Ribbon
控件和最近打开文件列表等等,文件菜单的内容需添加至 <startMenus>…</startMenus> 标签中,startMenus 中可以配置 startMenu 以及 startMenuPanel 标签子项,startMenu中可以配置subMenu子项。
文件菜单中的右侧区域为最近打开文件列表,并且可以进一步对最近打开的文件进行分组,即最近打开文件组,每一个分组的顶端会显示该组的标题,最近使用的文件会显示在相应的分组标题下面;文件菜单的左侧可以配置 Ribbon 控件,并且可以使用分隔条对控件进行分隔;文件菜单的最底部还可以配置按钮,如下图所示,称为最底部按钮。
在配置文件中,文件菜单的配置内容必须放置在 <startMenus>…</startMenus> 标签中,下面详细介绍 <startMenus>…</startMenus> 标签的各个属性的含义与作用:
<startMenus>
<startMenu id="sampleData" index="4" label="示范数据">
<subMenu id="workspace" index="0" label="工作空间">
<button checkState="false" image="../resources/DataView/Icon/Home/Workspace/File.png" index="3" label="中国1:100万数据 ( China.smwu )" onAction="CtrlActionExampleData" screenTip="../sampleData/China/China100/China.smwu" screenTipImage="" visible="true"/>
<button checkState="false" image="../resources/DataView/Icon/Home/Workspace/File.png" index="7" label="CBD ( CBD.smwu )" onAction="CtrlActionExampleData" screenTip="../sampleData/3D/CBDDataset/CBD.smwu" screenTipImage="" visible="true"/>
</subMenu>
<startMenuPanel id="licenseManager" index="98" label="许可信息" component="com.supermap.desktop.frame.license.JPanelLicenseManager" screenTip="" screenTipImage="" visible="true"/>
<startMenuPanel id="OnlineServers" index="99" label="服务" component="com.supermap.desktop.frame.cloud.JPanelOnlineServers" screenTip="" screenTipImage="" visible="true"/>
<startMenuPanel id="setting" index="100" label="选项" component="com.supermap.desktop.frame.ctrlAction.settings.JDialogSettings" screenTip="" screenTipImage="" visible="true"/>
<startMenuPanel id="settingResources" index="101" label="关于" component="com.supermap.desktop.frame.ctrlAction.settings.JPanelSettingResources" screenTip="" screenTipImage="" visible="true"/>
</startMenus>
startMenu属性
属性 | 说明 |
---|---|
id | 唯一标识,支持多个不同配置文件里的项进行合并显示,根据相同 id 进行合并显示。 |
index | 用于控制 startMenu 的显示顺序。 |
label | 文件菜单中的显示文本。 |
onAction | 通过该属性可以指定用于响应控件的点击事件所执行的内容,该属性可以指定为一个继承 CtrlAction 类或者实现了 ICtrlAction 接口的类。 |
screenTip | 指定鼠标停留在控件上时所显示的提示信息。 |
screenTipImage | 鼠标停留在控件上时将显示提示信息,该属性可以在提示信息中插入图片以辅助信息说明,只支持设置为与应用程序的相对路径。 |
备注 :图片需与应用程序在同一个磁盘中。
visible | 指定控件是否可见,该属性的值为 true 时,表示可见,false 为不可见。
subMenu属性
subMenu 用于显示文件菜单中的二级菜单,subMenu子项仅支持button控件。其属性说明如下:
属性 | 说明 |
---|---|
id | 唯一标识,支持多个不同配置文件里的项进行合并显示,根据相同 id 进行合并显示。 |
index | 用于控制 startMenu 的显示顺序。 |
label | 文件菜单中的显示文本。 |
startMenuPanel属性
startMenuPanel 用于显示文件菜单中自定义的面板。其属性说明如下:
属性 | 说明 |
---|---|
id | 唯一标识,不同配置文件中的 startMenuPanel,可根据 id 合并为一个 startMenuPanel。 |
index | 索引,用于控制startMenuPanel控件的加载顺序。 |
label | 控件显示的文本。 |
component | 实现的StartMenuPanel类的完整路径 |
screenTip | 指定鼠标停留在控件上时所显示的提示信息。 |
screenTipImage | 鼠标停留在控件上时将显示提示信息,该属性可以在提示信息中插入图片以辅助信息说明,只支持设置为与应用程序的相对路径。 |
备注 :图片需与应用程序在同一个磁盘中。
visible | 指定控件是否可见,该属性的值为 true 时,表示可见,false 为不可见。