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函数 .. 198 如何在分页显示数据时，使后续页的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文件)必须有如下代码：<span id="spanObjGrid " ></span> 其位置放在表单fm中id名称必须是：span+MulLine的对象名（这里是ObjGrid）(2)在JS文件中(如xxxInit.js文件)的JavaScript函数中如下设置假定产生3行两列的MulLine对象<script language="JavaScript">function initObjGrid() //函数名为init+MulLine的对象名ObjGrid{var iArray = new Array(); //数组放置各个列try{iArray[0]=new Array();iArray[0][0]="序号"; //列名（序号列，第1列）iArray[0][1]="30px"; //列宽iArray[0][2]=10; //列最大值iArray[0][3]=0; //1表示允许该列输入，0表示只读且不响应Tab键// 2 表示为容许输入且颜色加深.iArray[1]=new Array();iArray[1][0]="示范列1"; //列名（第2列）iArray[1][1]="30px"; //列宽iArray[1][2]=10; //列最大值iArray[1][3]=0; //是否允许输入,1表示允许，0表示不允许//后续可以添加N列，如上设置//生成对象区，规则：对象名=new MulLineEnter(―表单名‖,‖对象名‖);ObjGrid= new MulLineEnter( "fm" , "ObjGrid" );//设置属性区(需要其它特性，在此设置其它属性)ObjGrid.mulLineCount = 3 ; //行属性：设置行数=3ObjGrid.displayTitle = 1; //标题属性：1显示标题(缺省值) ,0隐藏标题//对象初始化区：调用对象初始化方法，属性必须在此前设置ObjGrid.loadMulLine(iArray);}catch(ex){ alert(ex); }}</script>上面是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("ObjGridNo"); //得到序号列的所有值String tGrid1 [] = request.getParameterValues("ObjGrid1"); //得到第1列的所有值String tGrid2 [] = request.getParameterValues("ObjGrid2"); //得到第2列的所有值Int Count = tGridNo.length; //得到接受到的记录数For(int index=0;index< Count;index++){System.out.println("GridNO="+ tGridNo [index]);System.out.println("Grid 1="+ tGrid1 [index]);System.out.println("Grid 2="+ tGrid2 [index]);}%>如果需要处理被选中的纪录（即CheckBox 和Radio 框）请参看中级特性说明5 如何在JSP中给MulLine赋值即在JSP页面中内嵌JavaScript代码，如：<script language="javascript">parent.fraInterface..ObjGrid.addOne("ObjGrid"); //添加一行，见该方法说明parent.fraInterface..ObjGrid.setRowColData(行,列,值);</script>注意：不要使用parent.fraInterface..fm .ObjGrid 方式，否则会报错：没有该对象注意：在将JSP变量传给setRowColData方法的参数3时，请用引号扩住。