Previous topicNext topic
Help > 开发指南 > 窗体开发 > 控件参考 > 控件参考 > 常用控件 >
SmDropDownBox(Sm下拉组合框)

SmDropDownBox(下拉组合框)

SmDropDownBox继承自C1DropDownControl(C1TextBox ),实现了IControlIBindingControl 接口。

常用属性

名称 中文属性名 描述
DataMap 字典 可以设置显示的字典。
SearchDelay 延迟触发 设置触发TextChange事件的延迟时间。如果设置的值小于等于0,则认为立即触发TextChange事件,如果设置了大于0的值后,则会在相应的多少毫秒之后触发TextChange事件。如果在这个时间内再更改Text属性的话,就会自动取消此次的TextChange事件。这个功能主要是为了适应一些通过TextChange事件筛选数据的场景,可以不需要频繁地触发TextChanged事件,以达到提升软件性能的目的。
WatermarkText 水印文本 设置当前控件的水印文本。在没有设置任何值时,显示的提示用户的相关信息。
DropDownFormName 下拉窗体名称 我们可以指定一个自定义的下拉窗体给SmDropDownBox控件,然后就可以直接点下拉按钮打开下拉窗体。
AllowEditValue 允许编辑 是否用户手动输入数值。

方法

方法 说明
CloseDropDown()  关闭下拉列表。
CloseDropDown(Boolean) 关闭下拉列表。
OpenDropDown 显示下拉列表。
SetProposedValue 此方法的工作原理与设置Value属性完全相同,只是它不会在编辑之前更改存储值的内部变量,因此用户可以按Esc键并恢复以前的值。此方法仅在编辑或下拉列表模式下有效。如果控件未处于编辑或DropDownList模式,则此方法不执行任何操作。
SpinDown 模拟点击向上按钮动作。
SpinUp 模拟点击向下按钮动作。

主要事件

TextChanged事件,主要指控件的文本变更后触发。

ValueChanged事件,主要指控件的值变更后触发。

事件

事件名称 说明
BeforeDropDownOpen 刚好在打开下拉列表之前发生。
CustomButtonClick 单击“自定义”按钮时发生。
DropDownClosed 关闭下拉列表时发生。
DropDownOpened 在打开下拉列表后发生。
DropDownOpening 淘汰的刚好在打开下拉列表之前发生。
ModalButtonClick 单击“模式”按钮时发生。
UpDownButtonClick 单击UpDown按钮时发生。