Table of Contents

下拉框

下拉框的XML标签为Combo,其实现类为XComboCtrl,下拉框包含若干选项,每个选项可绑定一个值,数据交换宏为DX_Combo(交换变量类型为整型,对应当前选项绑定的整数值)或DX_ComboStr(交换变量为文本字符串,对应当前选项的显示文本)或DX_Combo_Default(与DX_Combo类似,区别是如果用户没有选择任何选项,会按照默认值交换到变量中),它支持若干扩展:过滤扩展,选项配置文件扩展,单位扩展。下拉框的下拉项可以与Tab控件或Stack控件的子控件项绑定对应,即Tab控件或Stack控件会根据下拉框的当前选项切换到对应的子控件上。一般Tab控件(或Stack控件)在加载时会把所有的子控件构建出来,在某些情况下,由于子控件所包含的内容较多,导致对话框加载较慢,为了解决这个问题,可以为下拉框的选项设定ref_url属性以指定和它关联的子控件的配置文件,这样子控件的构建只有在切换到下拉框对应的选项时才实时构建,有效提高第一次加载对话框的速度。

控件属性关键字

name

控件名,其值类型为字符串,控件名只能以字母开头,可包含数字、下划线、点符号。参考示例:name=“value.combo”。

cid

关联命令标识符,其值类型为字符串,仅在菜单栏、工具条或功能导航栏中使用,用于与标识符为给定值的命令关联绑定,点击按钮的操作将触发关联命令,如果当前文档不存在指定标识符的命令,则按钮不可用。关联命令一般用于显示或修改应用文档的整数型选项状态值,每个选项都以文本显示在下拉框中。参考示例:cid=“SetCurrentResult”。

enable

设置控件的初始状态是否可交互,其值类型为布尔型(true或者false),如设置为false,在该控件会变灰并且不可交互,用户可调用ICommandWindow的setControlEnable接口修改该属性。参考示例:enable=“true”。

width

控件的宽度,其值类型整型, 单位为像素。参考示例:width=“30”。

height

控件的高度,其值类型整型, 单位为像素。参考示例:height=“30”。

label

仅当在表单布局中添加下拉框时使用,用于指定该控件所对应的标签的显示文本。参考示例:label=“显示文本”。

connect

动态事件信号的映射处理,下拉框支持的触发信号包括currentIndexChanged(当下拉框的当前选项发生改变时触发)、activated(当下拉框选项被激活时)。参考示例:connect=“currentIndexChanged,test.stack:setCurrentWidget”。

value

将下拉框下拉选项中值为给定值的选项设为当前选项,如果。参考示例:value=“50001”。

filterable

设置下拉框是否可过滤,其值类型为布尔型(true或false),如果设置其支持过滤,下拉框将根据已输入的字符串匹配下拉项供用户选择,默认不可过滤。参考示例:filterable=“true”。

unit

设置单位下拉框的单位类型,当下拉框有该属性时,下拉框自动载入指定单位类型的所有单位,单位类型字符串可参考单位系统。参考示例:unit=“Length”。

ref_url

指向参考的配置xml文件路径,下拉框的选项配置通过解析xml文件获取(可参考下文下拉框选项配置文件示例章节)。该路径为相对路径,其参考路径为项目资源目录下的uisetting文件夹,特别的,如果要参考全局资源目录下的文件,该路径应以“~“开头,”~“表示全局资源目录下的uisetting子目录。参考示例:ref_url=“material/types.xml”或”~/material/types.xml”。

下拉框选项属性

value

给下拉框选项绑定值,其值类型整型, 单位为像素。参考示例:value=“50001”。

text

用于设置下拉框选项的显示字符串,其值类型为字符串。参考示例:text=“hello”。

设置下拉框选项的关联的控件名,该控件一般为Tab控件或者Stack控件的子控件。参考示例:link=“ctrl1”。

ref_url

设置下拉框选项的关联控件的配置XML文件路径,该路径为相对路径,其参考路径为项目资源目录下的uisetting文件夹。该选项仅当下拉框定义了connect属性(其中目标控件为Tab或者Stack控件)且选项定义了link属性时有效。特别的,如果要参考全局资源目录下的文件,该路径应以“~“开头,”~“表示全局资源目录下的uisetting子目录。参考示例:ref_url=“material/types.xml”或”~/material/types.xml”。

配置示例

<options>
	<Item text="选项1" value="1" link="ctrl1" ref_url="ctrl1.xml"/>
	<Item text="选项2" value="2" link="ctrl2" ref_url="ctrl2.xml"/>
</options>

相关API