程序设计规范(Delphi)

程序设计规范(Delphi)

1. 概述:

1.1. 编写目的

本规范规定了YUNTONG-TECH程序在编写过程中涉及到的程序文件和编码风格。

本规范以 Delphi 语言为标准制定,使用其它编程语言的编码风格和规范在相关的文档中规定。

1.2. 参考资料

(1)程序员指南,Microsoft Press

(2)Windows界面应用程序设计指南,Microsoft Press (3)Delphi 5 开发人员指南,机械工业出版社 (4)程序设计规范VB,聂俊华,北航十四系

2. 程序文件

1.1. 项目文件的组织

在Delphi中,按照项目为单位来组织程序文件。在一个典型的项目中包括: (1)项目文件(.DRP文件)含有工程主程序的Pascal源代码;

(2)单元文件(.PAS文件)项目中每个窗体的Pascal源文件,包含该窗体的所有声明和过程(包括时间处理过程);

(3)窗体文件(.DFM文件)含有一个窗体的设计属性的二进制文件,每个窗体的.DFM文件与.PAS文件相互对应;

(4)资源文件(.RES文件)编译的二进制资源文件,被链接到应用程序的可执行文件中; (5)项目选项文件(.DOF文件)存储了Project|Options菜单命令所设置的项目选项; (6)桌面设置文件(.DSK文件)存储了Tools|Options菜单命令所设置的桌面选项;

(7)包文件(.DPK/.BPL文件)用于共享组件、类、数据和代码的文件。源文件为.DPK文件,编译后为.BPL文件;每个软件项目应使用独立的目录,软件项目下的不同类别文件、不同模块分设子目录。

以下给出软件项目及软件模块中,设置子目录名称的规范: 子目录 说明

\\Bin 建立产品的工作目录,存放项目中所有可执行文件的当前版本。 \\Lib 与项目有关的库文件。

\\Man 包括项目的所有外部文档。包括手册、帮助文件、其他在线文档、README文件以

及其他将和产品一起发放到用户手中的文档。

\\SQL 存放数据库的SQL文件(只针对数据库程序的开发) 。

\\Res 包括应用程序的所有共享资源,如ICON(图表)、资源文件、Bitmap等。 \\Include 公用的窗体或Unit。

\\Control 存放项目内用的自编或第三方提供的控件。 \\Source 程序源代码\\Public 可以公用的模块或程序。

本规范在以下的各小节中具体说明Delphi 两种文件类型.PAS和.DFM在程序文件中的相关内容要求。

1.2. 常量定义

内容:

l 逻辑值的定义; l 常数值的定义; l 错误码的定义;

格式:一个定义占一行。如下: Const <常量> : 类型 = 值; //注释 说明:

使用 Const 语句来声明用于代替文字值的常数。

示例:Const C_SQL:string='select CH_USERER_ID from T_CD_USER'; //查询用户ID Const C_PI:real =3.1415926; //圆周率

1.3. 结构类型定义

内容:结构类型定义 格式: Type

<类型名> //结构说明注释

<变量名1> : 变量类型; //变量说明注释 <变量名2> : 变量类型; //变量说明注释 … End ;

说明:

<类型名>是以大写字母开头的字符串。结构定义中定义变量类型的语句从第二行第五列开始。 示例: type

TableList=record //系统树单元类型定义 InID : integer; //单元编号 Name : string; //单元名称

PID : string; //上一级单元名称

PT : PTableList; //指向下一单元类型的指针

end;

3. 程序风格

程序风格规定了每个语句的定位规则及程序中的注释。

1.1. 函数(Function)/过程(Procedure)风格

Name (变量 :变量类型[,…]); //函数/过程说明 Var

变量1:变量类型;//变量说明 变量2:变量类型;//变量说明 … Begin 语句; 语句; … End ;

注: 变量声明、语句均从第三列写起,如有缩进,每次缩进两列,并与相对应语句对齐。

1.2. 语句风格

说明:

l 在程序体中通常最多每十行有一个段落功能说明; l 规范使用各种语句;

l 语句中有缩进是以二列为单位。

1.2.1. 变量定义语句

Var

var_name : <数据类型>;

1.2.2. 赋值语句

var_name: = <表达式>;

1.2.3. 条件语句

If 条件 Then //注释

联系客服:779662525#qq.com(#替换为@) 苏ICP备20003344号-4