MulLine.js 使用说明

MulLine.js 使用说明

具体描述 .......................................................................................................................................... 3 一 约定和声明 ................................................................................................................................ 3 二 基础特性： ................................................................................................................................ 4

1如何初始化MulLine （含属性说明） ............................................................................... 4 2 如何在JavaScript中给MulLine赋值 ............................................................................ 5 3 如何在JavaScript中从MulLine取值 .......................................................................... 5 4 如何在JSP中得到MulLine中的值（必须提交页面） ............................................... 5 5 如何在JSP中给MulLine赋值 ....................................................................................... 6 6 如何添加一行 ................................................................................................................... 6 7 如何删除一行 ................................................................................................................... 6 8 如何删除所有行 ............................................................................................................... 7 9 如何删除所有空行 ........................................................................................................... 7 10 如何隐藏或显示‖+‖和‖--―标记 ....................................................................................... 7 11 如何锁定或解锁‖+‖和‖--―标记 ....................................................................................... 7 12 如何隐藏一列 (不鼓励使用该方法：显示效果不好) .................................................. 7 13 如何得到行数和列数 ....................................................................................................... 8 14 如何设置某一列的初始化值 ........................................................................................... 8 15 如何设置在页面上的显示宽度 ....................................................................................... 8 16 如何设置使指定行的某一列得到焦点 ............................................................................ 9 17 如何判断指定行的某一列是否得到焦点 ...................................................................... 9 三 中级特性： ................................................................................................................................ 9

1 如何使用CheckBox 选项框 ............................................................................................... 9

1．1 如何初始化CheckBox 选项框 ........................................................................... 9 1．2 如何判断该行CheckBox 选项框被选中 ........................................................... 9 1．3 如何选中或不选中所有行的CheckBox选项框 .............................................. 10 1．4 如何删除选中CheckBox 选项框的所有行 ..................................................... 10 1．5 如何选中指定行的CheckBox 选项框 ............................................................. 10 2 如何使用 Radio 单选框 ................................................................................................... 10

1．1 如何初始化Radio 单选框 .............................................................................. 10 2．2 如何判断该行的Radio 单选框被选中 .......................................................... 11

四 高级特性： .............................................................................................................................. 11

1 如何在MulLine中添加代码选择功能(即双击弹出选择下拉框) .................................. 11 2如何在MulLine中添加代码选择功能(即双击弹出选择下拉框，从前端自己传入数据) ................................................................................................................................................ 13 3 如何在MulLine中添加字段数据校验功能 ..................................................................... 15 4 如何在MulLine中添加双击相应事件，响应自己编写的JS函数 ............................... 15 5 如何在MulLine中单击CheckBox时响应开发人员外部编写的JS函数 .................... 16 6 如何在MulLine中单击RadioBox时响应开发人员外部编写的JS函数 ..................... 18 7 如何在MulLine中单击―+‖按钮和 ―–‖号按钮时响应开发人员外部编写的JS函数 .. 19 8 如何在分页显示数据时，使后续页的MulLine中的显示序号与纪录数一致 ............. 20 9 如何在使用代码选择功能时，设置弹出的选择下拉框的宽度 ..................................... 21

10 如何在使用代码选择功能时，强制刷新数据源 .......................................................... 21 11 如何在查询时使设置的代码选择列将编码显示为对应的汉字 .................................. 21

五 错误描述和诊断 ...................................................................................................................... 21

1 如果IE弹出对话框：没有该对象或未知的对象或者对象没有该方法 ....................... 21 2 如果弹出对话框：MulLine.js中某某方法出现异常 ...................................................... 21 3如果弹出对话框：MulLinejs中某某方法中指定了错误的列（或者行）..................... 22 4如果出现其它错误信息 ...................................................................................................... 22

具体描述

一 约定和声明

(1) 你使用得IE版本必须是5.5以上(包括5.5)

(2) 在后续的所有说明中，均假定MulLine的对象名为：ObjGrid ;该MulLine对象所在

的表单名为:fm

(3) 后续用到的行和列都是从0行0列开始。和数组是一致的(注：除非有特殊声明) (4) 所有调用方法和属性的名字遵循命名规则：首字母小写，后续单词首字母大写。

方法如：clearData，setRowColData，lock，unLock 属性如：mulLineCount，canAdd , locked

(5) 具体实例：请看Z:\\resource\\模版程序\\testMulLine下的示范待码)

运行：http://hostName:8900/ui/testMulLine/mulineTest.html (hostName是主机名)

(6) 高级特性中，均借助于外部函数，必须包含相应的外部文件

二 基础特性：

1如何初始化MulLine （含属性说明）

(1) 在显示MulLine的页面上(例如xxxInput.jsp文件)必须有如下代码：

假定产生3行两列的MulLine对象

上面是MulLine的初始化的基本用法，如果用到其他功能，请参阅该功能的详细说明，

会有一些相关的初始化的附加设置。

2 如何在JavaScript中给MulLine赋值

使用MulLine对象的setRowColData(row,col,value)方法

参数为：行，列，值 ;返回值为真假

如;ObjGrid. setRowColData(0,1,‖赋给第0行第1列的值‖);

注意：是从0行0列开始。因此，我们认为0行是第0行，0列是第0列 注意：第3个参数，value如果不是变量，请用引号扩住

注意：如果程序弹出对话框：提示setRowColData时指定了错误的行（或列），那么

意味着你在赋值时指定的行或列超出了范围（即小于0或者大于行数或列数）

注意：请不要给0列赋值，因为是序号列，会自行变化

3 如何在JavaScript中从MulLine取值

(1) 取出指定的第几行第几列的值

使用MulLine对象的getRowColData(row,col)方法 参数为：行，列; 返回值：指定行和列的值 如：var value=ObjGrid. getRowColData(0,1);

注意：是从0行0列开始。因此，我们认为0行是第0行，0列是第0列 注意：如果程序弹出对话框：提示getRowColData时指定了错误的行（或列），那么

意味着你在取值时指定的行或列超出了范围（即小于0或者大于行数或列数） 注意：可以得到0列（序号列）的值 （2）取出指定的某一行的值

使用MulLine对象的getRowData(row) 法方

参数为：行号 ; 返回值：指定行的所有值,返回形式为一维数组 如：var iArray=ObjGrid. getRowColData(0);

注意：是从0行开始。因此，我们认为0行是第0行。

注意：如果程序弹出对话框：提示getRowData时指定了错误的行，那么意味着你在

取值时指定的行超出了范围（即小于0或者大于行数）

注意：数组iArray值不包括序号列的值。即iArray[0]为该行第1列的值，依次类推。

4 如何在JSP中得到MulLine中的值（必须提交页面）

提交有MulLine的页面后，在接受页如下处理： <%

String tGridNo[] = request.getParameterValues(\ //得到序号列的所有值 String tGrid1 [] = request.getParameterValues(\得到第1列的所有值 String tGrid2 [] = request.getParameterValues(\得到第2列的所有值

百度搜索“77cn”或“免费范文网”即可找到本站免费阅读全部范文。收藏本站方便下次阅读，免费范文网，提供经典小说综合文库MulLine.js 使用说明在线全文阅读。