PB编程规范.doc

PB编程规范及常见问题 发布日期：2010/9/4 8:19:49 来源： 作者： 点击：296 一、开发标准与命名约定 l???????? 在代码开发中，所有的运算符（+ 、-、 *、 / 、〈、〉等）及赋值动词（＝）的前后者应加上一个空格，最好在函数的参数表中的每个变量前面也要加入一个空格。如：wf_Dfjs_Dldb( Ad_zdl, As_lb ) 。 l???????? 应使用TAB而不是空格来缩排循环或复合语句中的代码，显示其包含关系。 l???????? 函数名，事件名或变量名的定义一律用英文书写（不便定义的用拼音首字母），要求能从字面上表示清楚；变量尽量不要出现嵌套，函数不要用敏感字符（如ItemChanged）；首字母用大写，单词之间不用连字符（＿）如：wf_RightTrim() 。 l???????? SQL语句首字母大写，同时要考虑SQL的通用性（Oracle 、SQLServer 、 SQLanywhere），使用标准SQL语句。 l???????? 单行结构的语句尽量分解多行： ????????????? If n_Rows 6? then ???????????????????? dw_report.Retrieve() ????????????? EndIf 而非??? If n_Rows 6 then dw_report.Retrieve()? 。 l???????? 在函数或事件代码中，应加入相应的注释内容与函数头（事件头）如下所示： ????????????? /////////////////////////////////////////////////////////////////////////////////// ????????????? /* Function: () ?????????? Access:? Public ????????????? Arguments:??????????? ????????????? Returns: ????????????? Description:? */ ????????????? //////////////////////////////////////////////////////////////////////////////////// ????????????? //以下开始为代码 ??? 代码中功能块之间要有明显标记，至少隔行区分；各功能块前有明确功能注释。 l???????? 函数的功能要分明，尽量不要出现一个函数完成多个任务的情况。 l???????? 循环变量：对于循环变量，允许定义单字母：I、J、K；以及M、N、L，但这些变量的定义仅限在Local中。不同的循环使用不同的循环变量。 l???????? PBL的命名规则应为PPP_OOOO , PPP为项目缩写，OOOO为能体现此库的内容的缩写。 l???????? 窗口、数据窗口对象命名：A_B_C_D_E_F_G Eg：d_ys_ qtbz_ ds_10KV_free_arg A:类型，如D为数据窗口、W为窗口、DD为子数据窗口 B:模块，如PW指配网图形、YS指预算 C: 对象，如DEFL指定额分类 D: 用途，如LR为“录入”、CX为“查询”、DS为数据存储 E:扩展，如对于取费标准可能分为10KV、35KV等 F:格式，如Freeform、Grid G:补充，如arg表示带参数 二、开发界面规范 1、 总则 l???????? 系统整体界面采用MDI多文档界面。系统使用一个主窗口，每个细分功能使用一个MDI子窗口。 l???????? 要求界面在完成功能的前题下，能做到清晰、大方、整齐。 l???????? 窗口及窗口控件一律继承。 **模板核心代码集中在W_MOD_BASE中，其他模板窗口只是为了方便开发，可另存模板窗口； **祖先代码不允许屏蔽； **窗口名称、窗口类型在开发方案中确定。 2、 窗口区域分隔 l???????? 菜单：位于MDI主窗口上，各MDI子窗口不再设菜单，子窗口内功能实现由命令按钮来完成。 l???????? 操作选择区：POPUP或RESPONSE窗口命令按钮放置在数据显示区的下方或右边。 3、 窗口及窗口控件 l???????? MDI子窗口依其功能可以分为录入/修改，查询/统计，打印，条件录入等。 l???????? 窗口及窗口控件所用字体一律为宋体，9号，普通。 l???????? 作为信息提示用的文本域一律靠左对齐，无边框。字符前景色为TEXT（黑），背景色为ButtonFace。 l???????? 作为信息显示操作用的文本（输入）域一律靠左对齐。边框类型为3D LOWER BORDER。字符前景色为TEX