SmDropDownBox(下拉组合框)
SmDropDownBox继承自C1DropDownControl(C1TextBox ),实现了IControl、IBindingControl 接口。
常用属性
名称 | 中文属性名 | 描述 |
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按钮时发生。 |