配置复选框控件<checkBox>


在配置文件中,每一个复选框控件对应一个 <checkBox>…</checkBox> 标签,向界面中添加复选框控件,只需添加 <checkBox>…</checkBox> 标签,并对标签的属性进行相应的设置即可完成界面中复选框控件的添加,要添加多个复选框控件,就相应的添加多个 <checkBox>…</checkBox> 标签。

checkBoxControls

下面详细介绍 <checkBox>…</checkBox> 标签的各个属性的含义与作用:

<ribbon id="view" index="6" label="视图">
    <group id="View" image="../resources/Group/Icon/View/View.png" index="1" label="视图" rowCount="3" visible="true">
        <checkBox checkState="true" customProperty="" image="" index="1" label="工作空间管理窗口" onAction="CtrlActionWorkspaceManagerWindow" screenTip="控制是否显示工作空间管理窗口,该窗口支持以类似操作资源管理器文件的方式,管理工作空间中的数据源、地图等资源。" screenTipImage="" visible="true" width="0"/>
        <checkBox checkState="true" customProperty="" image="" index="5" label="目录管理" onAction="CtrlActionCatalogManager" screenTip="" screenTipImage="" visible="true"/>
    </group>
</ribbon>
  • index :用于排序 checkbox 控件,即当同一层次上存在多个 checkbox 控件时,每个 checkbox 控件将通过该属性的值来确定其排列次序。
  • label :checkBox 控件的显示名称。
  • visible :指定 checkbox 控件是否可见,该属性的值为 true 时,表示可见,false 为不可见。
  • checkState :默认 checkbox 控件的状态,该属性的值为 true 表示被选中,为 false 表示非选中。
  • onAction :通过该属性可以指定用于响应 checkbox 控件的选中事件所执行的内容,该属性可以指定为一个继承 CtrlAction 类或者实现了 ICtrlAction 接口的类。
  • screenTip :指定鼠标停留在 checkbox 控件上时所显示的提示信息。
  • screenTipImage :CheckBox控件上所显示的图标,只支持设置为与应用程序的相对路径。 备注 :图片需与应用程序在同一个磁盘中。
  • shortcutKey :指定CheckBox控件所对应的快捷键,即快捷键的功能与按钮控件的点击功能等同,该属性的值为快捷键的组合,格式为:[Ctrl] + [Alt] + [Shift] + [KeyName]。
  • customProperty :预留给用户自己设置相应的属性信息。
  • width :指定 checkbox 控件的宽度,数值的单位为:像素。