2可视对象的命名.docVIP

目录 一、编写目的 2 二、主要内容 2 三、定义 3 1 库文件分类及命名 4 1.1原则一 4 1.2原则二 4 1.3原则三 4 2可视对象的命名 5 2.1 PowerBuilder的PBL对象中 5 2.2控件命名 5 3排版 5 4 注释 7 5 标识符命名 11 6 可读性 12 7 变量 13 8函数、过程 14 9 程序效率 14 10 质量保证 15  一、编写目的 PowerBuilder以其强大的数据窗专利技术而在数据库应用的前端开发中占据了相当的市场。但作为一个复杂的编程工具，完成一个复杂的应用时，对于编程中的约束及规范就显得相当重要。这样做可以带来许多好处： 1、程序可维护性强，特别是对于团队开发，万一人员变动，可以及时切入继续他的工作而不是废弃重来； 2、程序可读性强，大家都按照一种约束去做，别人写的程序就像自己写的一样； 3、符合软件开发过程控制要求，与开发文档结合，提交优质的系统设计报告； 4、提高源程序的质量和可维护性。 二、主要内容 本规范总则的内容包括： PBL库命名 可视对象命名规范； 变量命名使用规范 界面设计规范 排版、注释 标识符命名 代码可测性 程序效率 质量保证 三、定义 规则：编程时强制必须遵守的原则。 建议：编程时必须加以考虑的原则。 说明：对此规则或建议进行必要的解释。 示例：对此规则或建议从正、反两个方面给出例子。 1 库文件分类及命名 库文件(PBL,PowerBuilder Library)存放了所有的对象，是PB源程序中唯一的物理文件，因些其的规划和命令相当重要。 1.1原则一 一般来讲，按照PBL中存放的对象类型来规划和命名PBL，规则为 系统简称_存放类型.PBL 如sbgl_dw.pbl表示为设备管理系统存放数据窗口的PBL库 1.2原则二 对于一个系统来讲，PBL的规划根据对象类型应该按以下几个方式命名 系统名称.PBL 系统名称_dddw.PBL 系统名称_dw.PBL 系统名称_win.PBL 系统名称_obj.PBL 系统名称_fun.PBL 系统名称_pipe.PBL 系统名称_query.PBL 再加上公司的公用的PBL 系统名称.pbl：存放系统应用、菜单、结构 系统名称_dddw.PBL：存放下拉数据窗口 系统名称_dw.PBL： 系统名称_win.PBL：存放窗体 系统名称_obj.PBL：存放用户对象 系统名称_fun.PBL：存放函数 系统名称_pipe.pbl：如果用到比较多的数据管道，则要单独建立一个PBL存放对象，如果只有少数几个数据管道，则应放在系统名称_dw.pbl中 系统名称_Query.pbl：如果用到比较多的数据查询，则要单独建立一个PBL存放对象，如果只有少数几个数据查询，则应放在系统名称_dw.pbl中 1.3原则三 原则上每个PBL的大小不能超过1M，如果超过1M以后，则要考虑将一个PBL划分成两个，划分的规则是： 系统简称_存放类型1.PBL 系统简称_存放类型2.PBL 如设备系统存放窗口的PBL过大时，可将存放窗口的PBL划分为两个库，分别为：sbgl_win1.pbl、sbgl_win2.pbl 2可视对象的命名 2.1 PowerBuilder的PBL对象中 对象的命名一般采用如下前缀： 前缀 类型 --------------------------------------------------------------- dw_ DataWindows dddw_ DropDownDataWinows f_ Functions m_ Menus pipe_ Pipelines s_ Structures u_ UserObjects w_ Windows 2.2控件命名 在PowerBuilder的窗体中，控件的命名一般采用如下前缀： 前缀 控件类型 --------------------------------------------------------------- cbx_ CheckBox cb_ CommandButton dw_ DataWindow ddlb_ DropDownListBox em_ EditMask gr_ Graph gb_ GroupBox hsb_ HscrollBar ln_ Line lb_ ListBox mle_ MultiLineEdit ole OLE 2 0 ocx_ OCX oval_ Oval p_ Picture pb_ PictureButton rb_ RadioButto