pb开发规范.doc

PB开发规范
规范, 开发
目标:规范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
then
()
EndIf
而非
If n_Rows >6 then ()
。
l
在函数或事件代码中,应加入相应的注释内容与函数头(事件头)如下所示:
///////////////////////////////////////////////////////////////////////////////////
//
目标:
//
参数:
Ag1
//
Ag2
//
Ag3
//
返回值:
////////////////////////////////////////////////////////////////////////////////////
//以下开始为代码
      
l
PBL库的命名规则应为PPP_OOOO , PPP为项目缩写,OOOO为能体现此库的内容的缩写。
1、PB对象命名约定
对  象
前  缀
示  例
应用
N/A
Order_entry
应用级函数
af_
应用级结构
as_
窗口
w_
窗口函数
wf_
窗口结构
ws_
菜单
m_
菜单函数
mf_
菜单结构
ms_
标准用户对象
u_
定制类用户对象
_
标准类用户对象
u_cs_
可视定制用户对象
u_vc_
可视标准用户对象
u_vs_
用户对象函数
uf_
用户对象结构
us_
结构对象
s_
查询
q_
函数对象
f_
数据窗口对象
d_
2、PB数据类型命名约定
数据类型
前  缀
示  例
Blob
bb_
Window
w_
Menuitem
m_
DataWindow
dw_
DataWindowChild
dwc_
ListViewItem
lvi_
TreeViewItem
tvi_
UserObject
uo_
Integer
I_
Unsigned Integer
ui_
Long
l_
Unsigned Long
ul_
Boolean
b_
String
s_
Character
c_
Double
dbl_
Real
r_
Decimal
dec_
Date
d_
Structure
str_
Transaction
trans_
Time
t_
DateTime
dtm_
3 、PB控件命名约定
控  件
前  缀
示  例
CheckBox
cbx_
CommandButton
cb_
DataWindow
dw_
DropDownListBox
ddlb_
DropDownPictureListBox
ddplb
EditMask
em_
Graph
gr_
GroupBox
gb_
HscrollBar
hsb_
Line
ln_
ListBox
lb_
ListView
lv_
MultiLineEdit
mle_
OLE 2
ole_
Picture
p_
PictureButton
pb_
PictureListBox
plb_
RadioButton
rb_
Rectangle
r_
RichTextEdit
rte_
SingleLineEdit
sle_
StaticText
st_
Tab
tab_
Tab Page
tabp_
TreeView
tv_
UserObject
uo_
VscrollBar
vsb_
4 、PB变量作用域约定
范
围
前  缀
示