====== 复选框 ====== 复选框的XML标签为Check,数据交换宏为DX_Check,勾选或勾掉它会触发Event_Clicked事件,开发者在命令的onControlEvent接口中处理该事件。 ===== 控件属性关键字 ===== ==== name ==== 控件名,其值类型为字符串,控件名只能以字母开头,可包含数字、下划线、点符号。参考示例:name="value.btn"。 ==== cid ==== 关联命令标识符,其值类型为字符串,仅在菜单栏、工具条或功能导航栏中使用,用于与标识符为给定值的命令关联绑定,点击按钮的操作将触发关联命令,如果当前文档不存在指定标识符的命令,则按钮不可用。关联命令一般用于显示或修改应用文档的布尔型开关状态值。参考示例:cid="SetVisible"。 ==== enable ==== 设置控件的初始状态是否可交互,其值类型为布尔型(true或者false),如设置为false,在该控件会变灰并且不可交互,用户可调用ICommandWindow的setControlEnable接口修改该属性。参考示例:enable="true"。 ==== width ==== 控件的宽度,其值类型整型, 单位为像素。参考示例:width="30"。 ==== height ==== 控件的高度,其值类型整型, 单位为像素。参考示例:height="30"。 ==== label ==== 仅当在表单布局中添加按钮时使用,用于指定该控件所对应的标签的显示文本。参考示例:label="显示文本"。 ==== connect ==== 动态事件信号的映射处理,复选框支持的触发信号包括toggled(当勾选或勾掉勾选框时触发)。参考示例:connect="toggled,value.edit:setEnabled"。 ==== text ==== 用于设置复选框的显示字符串,其值类型为字符串。参考示例:text="hello"。 ===== 配置示例 ===== ===== 相关API ===== * [[class:ui:icommandwindow#setcontrolenable|setControlEnable]] * [[class:ui:icommandwindow#setcontrolvisible|setControlVisible]] * [[class:ui:icommandwindow#getchecked|getChecked]] * [[class:ui:icommandwindow#setChecked|setChecked]]