NC5轻量级组件技术红皮书讲义.doc

此文件受到UFIDA的保护, 并已在保护中心注册, 外泄必纠! UFIDA GUID1{574F03DC-4A25-711B-A9D6-33DB8623DB38} UFIDA GUID1{74745A68-B71F-0DA3-24F2-D0FE63EAB9C1} NC Rich Client 轻量级组件技术红皮书 NC-UAP 5.0 用友NC-UAP 2007-01-12 目 录 第一章 前言 1 1. 文档介绍 1 2. 概述 1 3. 组件整体继承关系介绍 1 第二章 各组件详细设计与使用方法介绍 2 1. BaseComponent 2 2. ConfirmDialogComp 5 3. MessageDialogComp 6 4. WarningDialogComp 7 5. ErrorDialogComp 9 6. ProgressDialogComp 10 7. PanelComp 11 8. TabComp 12 9. ButtonComp 14 10. ComboComp 16 11. ListToListComp 19 12. StringTextComp 22 13. IntegerTextComp 24 14. DateTextComp 25 15. FloatTextComp 26 16. TreeViewComp 27 17. OutLookBarComp 31 18. SliderbarComp 33 19. GridComp 35 前言 文档介绍文档目的文档范围读者对象术语与缩写解释缩写、术语 解 释 概述 在为传统的web应用编写HTML页面的时候，页面编写者只有非常有限的一套预定义GUI组件，即HTML表单元素。他们的特征集在近10年的时间里几乎没有什么变化，与现代的GUI工具集相比，它们是非常基础的。如果页面作者希望引入树控件或者可编辑的栅格、日历控件或者分级菜单之类的，就需要借助于基础文档元素的底层编程。由于开发Portal的需要，为了Portal更具实用性和易用性，同时随着Ajax技术的逐渐流行，客户端的重视程度日益提高，为了很好的利用Ajax技术提高web界面的响应速度，并带给用户更好的浏览体验，开发一套适用于portal并具有一定灵活性和可扩展性的基础控件库也成了势在必行的工作。 组件整体继承关系介绍 由于JavaScript代码均是下载到客户端解释执行，所以为了减轻客户端压力，类的继承层次不能太深，否则在客户端运行时代码的执行速度就会变慢，生成的原始js代码就会增多，考虑这个效率原因，NC Rich Client的大部分组件均采用一级继承，即直接继承自基类BaseComponent。  各组件详细设计与使用方法介绍 BaseComponent 组件名称：BaseComponent 组件类型：所有控件的基类 组件说明 所有控件基类,包含了所有控件的共同属性和操作方法，此类不需要用户主动调用。 以下给出了这个类的详细函数原型描述。 函数介绍 6) 7） 8） 9） 10） 11) 12) 13) 14) 15) 16) 17) 18) 19) 20) ConfirmDialogComp 组件名称：ConfirmDialogComp 组件类型：Container 组件父类：ModalDialogComp 组件说明 此确认对话框是对ModalDialog的封装实现。在对话框底部添加了OK, Cancel按钮，使用者使用时只需提供Ok,Cancel相对应的处理函数，给出需要显示的内容信息即可。 组件最终效果展示 (图3.2-1 确认对话框) 组件皮肤设置说明 confirmdialog.css是对ConfirmDialog中显示字体的外观控制，如字体，大小等 modaldialog.css是对ConfirmDialog外观整体的控制，包括标题背景，内容区背景等 组件使用说明 使用tag标签的用法 msg：你需要显示的提示信息 ok: 点击确认后需要执行的函数名称 cancel: 点击取消后需要执行的函数名称 不使用tag标签的用法 confirmdialog = ConfirmDialogComp.showDialog(msg);// 用需要显示的字符串代替msg confirmdialog.onOk = confirm; //把点击确认按钮后需要执行的函数名赋给onOk属性 confirmdialog.onCancel = noconfirm; //把点击取消需要执行的函数名赋给onCancel属性 用户可调用的组件函数和组件事件说明 注：以下的函数均假定已经生成了confirmdialog对话框实例 /** * 改变对