配置文件菜单<startMenu>


程序应用界面的最左上角的按钮为“文件”按钮,点击“文件”按钮后会弹出文件菜单。在文件菜单上可以放置 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子项仅支持button控件。其属性说明如下:

属性 说明
id 唯一标识,支持多个不同配置文件里的项进行合并显示,根据相同 id 进行合并显示。
index 用于控制 startMenu 的显示顺序。
label 文件菜单中的显示文本。

startMenuPanel属性

startMenuPanel 用于显示文件菜单中自定义的面板。其属性说明如下:

属性 说明
id 唯一标识,不同配置文件中的 startMenuPanel,可根据 id 合并为一个 startMenuPanel。
index 索引,用于控制startMenuPanel控件的加载顺序。
label 控件显示的文本。
component 实现的StartMenuPanel类的完整路径
screenTip 指定鼠标停留在控件上时所显示的提示信息。
screenTipImage 鼠标停留在控件上时将显示提示信息,该属性可以在提示信息中插入图片以辅助信息说明,只支持设置为与应用程序的相对路径。

备注 :图片需与应用程序在同一个磁盘中。
visible | 指定控件是否可见,该属性的值为 true 时,表示可见,false 为不可见。