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的初始化的基本用法，如果用到其他功能，请参阅该功能的详细说明，