Dorado 5 : 1.2.1.DropDown综述 (RF2)

下拉框对象一般被用于界面数据的输入辅助,在某些行业中也称为参照输入。
Dorado中的下拉框对象除了具有输入功能之外还提供了数映射功能。
另外值得注意的是下拉框对象没有相对应的tag标签,在整个生命周期中他是一个独立的对象,只在需要时才显示,在dorado开发时,下拉框通常都被绑定到dataset的field上或编辑框中,这就意味着下拉框对象是依赖其他组件才能运行的。
针对不同的数据录入方式以及数据结构,dorado提供了以下五种类型的下拉框:
ListDropDown(列表下拉框):下拉框中的列表项是在设计期或者视图模型的第一次初试化过程中动态生成的。
DateDropDown(日期下拉框): 日期下拉框,提供日历器供用户选择日期
DatasetDropDown(记录集下拉框):下拉框中的列表项来自一个dataset对象
DyanmicDropDown(动态下拉框):下拉框中的数据来自数据坞中的一个数据集,系统默认提供分批数据下载功能,对于大数据量列表选择时可以比较方便的设计,并获得比较高的性能处理(dorado内部提供了很多的优化处理机制)
CustomDropDown(自定义下拉框):引用一个外部View在下拉框中展示,便于实现各种匪夷所思的界面风格

主要属性说明

所有的dropdown对象都具有的属性如下:

属性

说明

autoDropDown

光标定位在绑定下拉框的编辑框时是否自动打开该下拉框,默认为false

fixed

是否锁定绑定下拉框的编辑框对象,使得不能直接在编辑框中通过键盘输入,而必须通过下拉框选择完成输入,默认为false

height

下拉框的绝对高度设定

width

下拉框的宽度设定

主要事件说明

所有的dropdown都具有的方法如下:

事件

说明

public DoradoException beforeOpen(DropDown dropdown)

在下拉窗口将要打开前触发
如果您返回了一个异常,那么系统将显示此异常信息并终止后续默认的操作.如:
return new DoradoException("无法进行此项操作!");
如果您返回null或者没有定义任何返回值,那么系统将继续执行后续默认的操作.
如果您希望终止后续默认的操作但又不希望显示任何异常信息,那么请返回一个AbortException对象.如:
return new AbortException ();

public Boolean onSelect(DropDown dropdown, Object selectedObject, TextEditor editor)

当选择中下拉框数据项后触发
此事件的返回值被用于通知系统是否要继续完成后续的为编辑框或数据集赋值的操作.返回true表示继续默认的赋值操作.
参数说明:
dropdown - 触发事件的下拉框对象
selectedObject - 在下拉框中被选中的对象
editor -打开此下拉框的编辑框对象