功能

实现dataset的记录光标移动以及dataset记录的增删改操作。
组件效果图如下:

图表 113

使用

可在JSP中添加DataPilot标签，并设定其绑定的dataset属性，如果已经在View中设置过dataset属性，则在标签申明中就可以省略该属性：

<d:DataPilot id="" dataset="" />

常用技巧

如何设定部分按钮的可见性

通过DataPilot的属性设定：

属性	说明	可取值
buttonAppend	添加按钮	auto,visible,hidden
buttonCancel	取消按钮	auto,visible,hidden
buttonDelete	删除按钮	auto,visible,hidden
buttonInsert	插入按钮	auto,visible,hidden
buttonMoveFirst	第一条按钮	auto,visible,hidden
buttonMoveLast	最后一条按钮	auto,visible,hidden
buttonMoveNext	下一条按钮	auto,visible,hidden
buttonMovePrev	上一条按钮	auto,visible,hidden
buttonPost	验证按钮	auto,visible,hidden
buttonNextPage	下一页按钮	auto,visible,hidden
buttonPrevPage	上一页按钮	auto,visible,hidden

xml定义范例如下:

其中visible表示按钮可见，hidden表示隐藏。auto值却另有含义的含义：表示相关按钮的是否显示由绑定的datasetEmployee决定，怎么解释呢？例如当dataset的readOnly为true时，datapilot的插入按钮，删除按钮，添加按钮，取消按钮等九自动隐藏。设置auto就表示按钮按照dataset的状态决定。

如何捕捉导航条上不同按钮的单击事件

DataPilot的按钮单击时，系统提供了onButtonClick事件，以便于开发人员定制其代码：

图表 114
如上图选择datapilot1对象之后，切换到Events Inspector面板后，可以在Event列表中看到onButtonClick事件。
事件的申明如下：

public String onButtonClick(DataPilot pilot, HtmlElement button, String buttonName)

当单击数据导航条上的按钮时触发
说明:可以通过为此事件定义一个逻辑型的返回值来通知系统是否继续执行标准的按钮操作。
Parameters
pilot - DataPilot - 触发事件的数据导航条对象
button - HtmlElement - 触发事件的按钮
buttonName - String - 触发事件的按钮的类型

按钮类型的取值有以下的几种：
movefirst 移动至第一条记录
pervpage 向前翻页
moveprev 移动至前一条记录
movenext 移动至下一条记录
nextpage 向后翻页
movelast 移动至最后一条记录
insertrecord 插入一条记录
appendrecord 追加一条记录
deleterecord 删除一条记录
cancelrecord 撤销对当前记录的修改
postrecord 验证对当前记录的修改

Returns:
String

注意参数中的buttonName，DataPilot中不同的按钮都会触发该事件，我们可以通过判断buttonName知道该事件究竟由哪个按钮触发的。
例如下例：

图表 115
在onButtonClick事件中判断buttonName的值，如果为"movefirst"则alert信息提示。

如何修改按钮的默认文字

按钮的默认标题文字是由系统全局设定的，采用了I18N技术，详细原理参考<<dorado 5 用户指南v1.1.doc>>的I18N部分。找到home文件夹下的i18n/smartweb/v2/client_cn_ZH.properties文件，其中包含的申明代码：

__DATAPILOT_MOVE_FIRST=第一条记录
__DATAPILOT_PREV_PAGE=上一页
__DATAPILOT_MOVE_PREV=上一条记录
__DATAPILOT_MOVE_NEXT=下一条记录
__DATAPILOT_NEXT_PAGE=下一页
__DATAPILOT_MOVE_LAST=最后一条记录
__DATAPILOT_INSERT_RECORD=插入
__DATAPILOT_APPEND_RECORD=添加
__DATAPILOT_DELETE_RECORD=删除
__DATAPILOT_POST_RECORD=验证
__DATAPILOT_CANCEL_RECORD=撤销
__DATAPILOT_PAGEINFO=第${pageIndex}页/共${pageCount}页

通过修改这部分信息即可，该处的修改会同步整个系统中的所有DataPilot的显示。该修改会引起整个项目中所有的DataPilot发生变化，如果我们只是为了某一个特殊的DataPilot而要求修改其标题文字，则我们可以通过DataPilot提供的onRefreshButton事件解决这个问题，该事件的声明如下：

public void onRefreshButton(DataPilot dataPilot, HtmlElement button, String buttonName)

当刷新数据导航条上的每一个按钮状态时触发
Parameters
dataPilot - DataPilot - 触发事件的数据导航条对象
button - HtmlElement - 要刷新的按钮对象
buttonName - String - 要刷新的按钮的类型

按钮类型的取值有以下的几种：
movefirst 移动至第一条记录
pervpage 向前翻页
moveprev 移动至前一条记录
movenext 移动至下一条记录
nextpage 向后翻页
movelast 移动至最后一条记录
insertrecord 插入一条记录
appendrecord 追加一条记录
deleterecord 删除一条记录
cancelrecord 撤销对当前记录的修改
postrecord 验证对当前记录的修改

Returns:
String

例如如下的代码：

图表 116
我们通过button对象的value属性修改其默认的标题信息。修改后界面效果如下图：

图表 117

属性说明

属性	说明
buttonAppend	新增按钮显示设置,可选值有: auto：根据记录集的状态决定 hidden：隐藏 visible：显示
buttonCancel	取消按钮显示设置,可选值有: auto：根据记录集的状态决定 hidden：隐藏 visible：显示
buttonDelete	删除按钮显示设置,可选值有: auto：根据记录集的状态决定 hidden：隐藏 visible：显示
buttonInsert	插入按钮显示设置,可选值有: auto：根据记录集的状态决定 hidden：隐藏 visible：显示
buttonMoveFirst	移动到第一条按钮显示设置,可选值有: auto：根据记录集的状态决定 hidden：隐藏 visible：显示
buttonMoveLast	移动到最后一条按钮显示设置,可选值有: auto：根据记录集的状态决定 hidden：隐藏 visible：显示
buttonMoveNext	移动到下一条按钮显示设置,可选值有: auto：根据记录集的状态决定 hidden：隐藏 visible：显示
buttonMovePrev	移动到上一条按钮显示设置,可选值有: auto：根据记录集的状态决定 hidden：隐藏 visible：显示
buttonNextPage	移动到下一页按钮显示设置,可选值有: auto：根据记录集的状态决定 hidden：隐藏 visible：显示
buttonPost	校验确认按钮显示设置,可选值有: auto：根据记录集的状态决定 hidden：隐藏 visible：显示
buttonPrevpage	移动到上一页按钮显示设置,可选值有: auto：根据记录集的状态决定 hidden：隐藏 visible：显示
confirmCancel	记录集取消编辑操作时，是否弹出信息确认框
confirmDelete	删除记录时是否弹出信息提示框
dataset	数据导航条绑定的数据集，该属性非空

常见错误

如下图:

图表 118
上图中的所有按钮均为灰色，这属于DataPilot未找到需要绑定的dataset对象导致，可能原因有:
1.未设定dataset属性;
2.当前视图模型中未找到dataset属性指定的dataset对象导致;

系统css文件为

.DataPilot BUTTON {
font-family: ARIAL;
font-size: 9pt;
}

Css说明:

Class名称	说明
BUTTON	DataPilot中按钮的风格设定

Dorado 5 : 2.4.10.DataPilot(记录导航条) (RF2)

功能

使用