普英集团Deplhi源代码编写规范.docVIP

计算机源代码编写规范 普英集团 Delphi源代码编写规范 Version 1.0 撰写人：薛永坤 审核人：刘吉鹏 批准人：刘吉鹏 日期：2007-3-5 文件修改控制 修改记录编号 修改 状态 修改页码及条款 修改人 审核人 批准人 修改日期 目录 1. 目的 2. 适用范围 3. 规范内容 3.1 标识符命名及书写规范 3.2 注释规则 3.3 缩进规则 3.4 窗体 3.5 控件 3.6 提示信息 计算机源代码编写规范 目的 良好的编程风格是提高程序可靠性非常重要的手段，也是大型项目多人合作开发的技术基础。本规范的目的在于通过规范定义来避免不好的编程风格，增强程序的易读性，便于自己和其它程序员理解，以下是程序开发工作流程图。 适用范围 本规定适用于所有软件的源程序编写。客户有特殊要求时，则遵循客户提出的要求。对于移植性开发或低版本的升级开发，则按照该版本的格式要求。 规范内容 3.1 标识符命名及书写规则 3.1.1 1) 这里的标识符是指编程语言中语法对象的名字，它们有常量名、变量名、函数名、类和类型名、文件名等，标识符的基本语法是以字母开始，由字母数字及下划线组成的单词。 标识符本身最好能够表明其自身的含义，以便于使用和他人阅读。按其在应用中的含义由一个或多个词组成。可以是英文词或中文拼音词。 当标识符由多个词组成时，每个词的第一个字母大写，其余全部小写，常量标识符全部大写。中文词由中文描述含义的每个汉字的头一个拼音字母组成。英文词尽量不缩写，如果有缩写，在同一系统中对同一单词必须使用相同的表示法。 标识的总长度不要超过32个字符。 具体的 具体约定 1)窗体及单元的命名 一个窗体的命名由四部分组成：“Frm”+“公司（B/R/X/…）”+“模快（PUR/INV/…）”+“具体的窗体名”。 如：FrmBSysReportShow FrmRPurPurchaseOrder FrmRSysConnection …… 一个单元的命名由四部分组成：“Unt”+“公司（B/R/X/…）”+“模快（PUR/INV/…）”+“具体的窗体名”。 如：UntBSysReportShow UntRPurPurchaseOrder UntRSysConnection …… 2)变量及控件的命名 一个变量的命名由三部分组成：“范围前缀”+“类型前缀”+“变量名字”。 变量范围分为三种： 全局变量，在模块中public 处以xxx :xxx; 来定义， 加前缀“G ”。 如：GStrUserName；GStrDeptName 模块变量，在模块中private 处以xxx : xxx;来定义，加前缀“M”。 如：MStrSQL；MStrFlag 过程变量，在函数或过程中 Var xxx : xxx;来定义，不加范围前缀。 类型前缀按照其变量类型的不同采用以下字符： 序号 类型 前缀 Example 1 Boolean Bln BlnFound 2 Date (Time) Dtm DtmStart 3 Integer Int IntQuantity 4 String Str StrFName 5 User-defined type Udt UdtEmployee 6 Currency Cur CurRevenue 7 Double Dbl DblTolerance 8 Byte Byt BytRasterData 9 Variant Vnt VntCheckSum 10 Single Sng SngAverage 11 Edit Edt EdtName 12 Botton Btn BtnClose 13 Combox Com ComCustType 14 CheckBox Chk ChkRun 15 RadioButton Rbtn RbtnRun 16 DateTimePicker Dtp DtpInvStart 17 TreeView Trv TrvList 18 PopupMenu Pmu PmuCheck 19 MainMenu Mmu MmuMain 20 Memo Mmo MmoText 21 BitBtn Bitn BitnOk 22 StringGrid Sgd SgdEmp 3.2 注释及格式要求 注释总是加在程序的需要一个概括性说明或不易理解或易理解错的地方。注释应语言简练、易懂而又准确，所采用的语种首选是中文，如有输入困难、编译环境限制或特殊需求也可采用英文。 3.2.1 1) 在文件的头部必须标明程序名称，它所完成的主要功能。 2) 文件的作者，及完成时间。 3) 阶段测试结束后，主要修改活动的修改人、时间、简单原因说明列表。 4)