/

按钮栏(Gallery)

ButtonGallery 控件只能放置在功能区中名为 Gallery 的容器控件中,Gallery 中可创建分组,如下图所示,ButtonGallery控件上的显示内容分为两个部分,控件上的图片为显示图标,而控件上的文字内容为控件的显示名称。ButtonGallery 控件类似于按钮控件,通过点击 ButtonGallery 控件即可实现与该控件绑定的功能。

buttonGalleryControls

Gallery属性

属性 说明
ID gallery 控件支持多个不同配置文件里的项进行合并显示,合并的依据就是通过 id 来实现的,也就是说我们可以在 A 插件的配置文件中配置一个 gallery 控件,指定一个 id,同时在 B 插件里面也配置一个 gallery 控件,指定相同的 id,在系统显示时,这两个 gallery 控件的中的内容将会合并到一起,放到一个 gallery 控件中。
索引 用于排序 gallery 控件,即当同一层次上存在多个 gallery 控件时,每个 gallery 控件将通过该属性的值来确定其排列次序。
文本 如果该属性不为空并且 screenTip 属性也不为空时,该属性的值将作为 screenTip 提示信息的标题显示。
可见 指定 gallery 控件是否可见,该属性的值为 true 时,表示可见,false 为不可见。
CtrlAction名称 通过CtrlAction实现Gallery中内容的动态构建。单击右侧 设置按钮,在弹出对话框中选择 指定的插件指定的类
单行最多显示数量 设置 gallery 控件最大显示多少列,即一行显示 buttonGallery 控件的个数,超过这个个数,gallery 控件中的 buttonGallery 控件将换行显示。
最大显示列数 指定 gallery 控件中每一个 buttonGallery 控件的宽度,gallery 控件总共显示多长是通过

galleryItemWidth 和 galleryMaxColumns 属性指定的值计算得到的。

Gallery按钮栏组属性(GalleryGroup)

属性 说明
ID GalleryGroup 支持多个不同配置文件里的项进行合并显示,合并的依据就是通过 id 来实现的,也就是说我们可以在 A 插件的配置文件中配置一个 GalleryGroup ,指定一个 id,同时在 B 插件里面也配置一个 GalleryGroup ,指定相同的 id,在系统显示时,这两个 GalleryGroup 中的内容将会合并到一起,放到一个 GalleryGroup 中。
索引 用于排序 GalleryGroup 控件,即当同一个gallery中存在多个 GalleryGroup时,每个 GalleryGroup

将通过该属性的值来确定其排列次序。
文本 | GalleryGroup 的显示标签。
可见 | 指定 GalleryGroup 是否可见,该属性的值为 true 时,表示可见,false 为不可见。
文本最大长度 | 控制 GalleryButton 文本的最大显示长度,当大于该长度时,会做字符串截取域省略。例如:文本最大长度设置为4,若 GalleryButton 的的文本设置为“ 关键要素分析 ”,则改按钮的名称会显示为“ 关键要素… ”。

Gallery按钮属性(GalleryButton)

属性 说明
文本 Gallery按钮控件的显示名称。
文本1 Gallery按钮控件的第一行子文本,仅在控件所在的GalleryGroup的尺寸设置为MEDIUM时生效。显示效果请参见备注。
文本2 Gallery按钮控件的第二行子文本,仅在控件所在的GalleryGroup的尺寸设置为MEDIUM时生效。显示效果请参见备注。
图片 Gallery按钮控件上所显示的图片路径,即与应用程序的相对路径。
ClassName 设置控件实现类的完整路径。单击右侧 设置按钮,在弹出对话框中选择 插件名称指定类的名称
Process的唯一标识 设置Process的唯一标识,不能重复,且必须与实现类中的getKey方法返回的结果一致。
索引 用于排序Gallery按钮控件,当同一层次上存在多个按钮时,每个按钮将通过该属性的值来确定其排列次序。
CtrlAction名称 通过该属性可以指定用于响应按钮控件的点击事件所执行的内容。单击右侧 设置按钮,在弹出对话框中选择指定的插件指定的类
提示信息 鼠标停留在Gallery按钮控件上时,所显示的提示信息。
提示图片 鼠标停留在Gallery按钮控件上时,显示的提示信息可以插入图片以辅助信息说明,该属性的值为图片与应用程序的相对路径。
快捷键 指定Gallery按钮控件所对应的快捷键,该属性的值为快捷键的组合,格式为:[Ctrl] + [Alt] + [Shift] + [KeyName],例如要定义拷贝的快捷键(Ctrl + C),同时按下[Ctrl] + [C]键即可。
可见 指定按钮控件是否可见,该属性的值为 true 时,表示可见,false 为不可见。
自定义属性 预留给用户自己设置相应的属性描述信息。
控件尺寸 该属性的值有三个,BIG 表示显示大图标、文本在图标下; MEDIUM表示显示为小图标其文本域图片同行; SMALL 表示只显示图片没有文本。
平台 该选项卡支持的操作系统平台,支持设置为All、Windows、Linux,All表示所有平台都支持,Windows表示只在Windows平台支持,Linux表示只在Linux平台支持。
语言 选择支持改选项卡功能的语言版本,提供ZH、US、JA、All四个选项,分别为中文、英文、日本、所有版本。

GalleryButton设置文本1与文本2的显示效果如下图:

buttonGalleryText12