PB开发规范.doc

目标：规范PB编码，提高项目质量方法：源代码规范与界面规范实现：MICROSOFT WORD、 POWERBUILD一、PB开发标准与命名约定l 在PB代码开发中，局部变量不使用作用域限定符，所有的运算符及赋值动词（）的前后者应加上一个空格，并且函数的参数表中的每个变量前面也要加入一个空格。如：wf_GetAttrib( id, name, date ) 。l 应使用TAB而不是空格来缩排循环或复合语句中的代码，显示其包含关系。l 函数名，事件名或变量名一律用英文书写，首字母用大写，单词之间不用连字符（）如：wf_RightTrim() 。l 数据库命令（INSERT ， SELECT ）使用全部大写。l 行延续时，连接标记应置于行尾。l 单行结构的语句应分解多行：If n_Rows 6 thendw_report.Retrieve()EndIf而非 If n_Rows 6 then dw_report.Retrieve() 。l 在函数或事件代码中，应加入相应的注释内容与函数头（事件头）如下所示：/ 目标：/参数： Ag1/ Ag2/ Ag3/返回值：/以下开始为代码l PBL库的命名规则应为PPP_OOOO , PPP为项目缩写，OOOO为能体现此库的内容的缩写。1、PB对象命名约定对 象前 缀示 例应用N/AOrder_entry应用级函数af_应用级结构as_窗口w_窗口函数wf_窗口结构ws_菜单m_菜单函数mf_菜单结构ms_标准用户对象u_ 定制类用户对象u_cc_标准类用户对象u_cs_可视定制用户对象u_vc_可视标准用户对象u_vs_用户对象函数uf_用户对象结构us_结构对象s_查询q_函数对象f_数据窗口对象d_2、PB数据类型命名约定数据类型前 缀示 例Blobbb_Windoww_Menuitemm_DataWindowdw_DataWindowChilddwc_ListViewItemlvi_TreeViewItemtvi_UserObjectuo_IntegerI_Unsigned Integerui_Longl_Unsigned Longul_Booleanb_Strings_Characterc_Doubledbl_Realr_Decimaldec_Dated_Structurestr_Transactiontrans_Timet_DateTimedtm_3 、PB控件命名约定控 件前 缀示 例CheckBoxcbx_CommandButtoncb_DataWindowdw_DropDownListBoxddlb_DropDownPictureListBoxddplbEditMaskem_Graphgr_GroupBoxgb_HscrollBarhsb_Lineln_ListBoxlb_ListViewlv_MultiLineEditmle_OLE 2ole_Picturep_PictureButtonpb_PictureListBoxplb_RadioButtonrb_Rectangler_RichTextEditrte_SingleLineEditsle_StaticTextst_Tabtab_Tab Pagetabp_TreeViewtv_UserObjectuo_VscrollBarvsb_4 、PB变量作用域约定范 围前 缀示 例Globleg?_Sharedsh?_Instancei?_Argumenta?_二、PB开发界面规范1、 总则l 系统运行平台为中文Win95或中文Win98。l 屏幕分辨率为800x600，大字体。l 系统整体界面采用MDI多文档界面。系统使用一个主窗口，每个细分功能使用一个MDI子窗口。l 要求界面在完成功能的前题下，能做到清晰、大方、整齐。2、 窗口区域分隔l 菜单：位于MDI主窗口上，各MDI子窗口不再设菜单，子窗口内功能实现由命令按钮来完成。l 数据显示操作区：位于MDI子窗口的中间主要部分。外框使用PB的GROUPBOX控件。若在数据显示操作区内还需对信息进一步分类，则每一类信息使用GROUPBOX作为外框，显示操作区整体不再设外框。l 操作选择区：在数据显示区的下方或右边可以放置命令按钮，并加GROUPBOX作为外框。l 记录信息显示区：一般可以设置在DATAWINDOW对象内的SUMMARY区。若有需要，也可以操作选择区的边上放置。窗口布局如下图所示：3、 窗口及窗口控件l MDI子窗口依其功能可以分为录入/修改，查询/统计，打印，条件录入等。l 窗口及窗口控件所用字体一律为宋体，9号，普通。l 作为信息提示用的文本域一律靠右对齐，无边框。字符前景色为TEXT（黑），背景色为BUTTONFACE，但当与之相关联的输入域为必输项时，字符前景色为BLUE。l 作为信息显示操作用的文本（输入）域一律靠左对齐。边框类型为3D LOWER BORDER。字符前景色为TEXT（黑色）；若只显示，则字符背景色为ButtonFACE,若可由用户输入，则字符背景色为WINDOWBACKGROUND。l 各输入域或带边框的文本域的高为61 （PB单位）。命令按钮的高为88（PB单位），宽为340（PB单位）。l 命令按钮的快捷方式为：“S存盘”，“X退出”，“I插入”，“A增加”，“D删除”，“C取消”，“P打印”，“Q查询”。遗漏项在实际工作中进行补充。l 作为外框用的GROUPBOX应使用3D LOWER BORDER。l MDI子窗口的高为1550，宽为2800（PB单位）。l POPUP窗口大小由需要决定，显示时位置为OWNER CENTER。4、 DATAWINDOW 对象l 主要使用FREEFORM或GRID两种风格的DW来表达数据。其中FREEFORM对应于主表结构的一条数据，GRID对应于从表结构的多行数据。l 日期域使用 YYYY/MM/DD格式来显示日期。若编辑风格为DROPDOWN ，则不选中ALWAYS SHOW ARROW项。l 在DW的SUMMARY区内可以加入记录信息，如当前记录位置，记录数等。字符前景色为BLUE。l DW内部的控件使用与上一部分相同的规则。在界面安排上，原则上用竖排4列，分别为文本提示区，字段信息区，文本提示区，字段信息区。5、 MESSAGEBOX 对话框l 系统中采用MESSAGEBOX来与用户进行简单的信息交互。l MESSAGEBOX共分成提示/交互/选择信息（用INFORMATION！图标），警告信息（用EXCLAMATION！图标），严重错误信息（用STOPSIGN！图标）。l 提示/交互/