VisualBasic编码标准.docx
《VisualBasic编码标准.docx》由会员分享，可在线阅读，更多相关《VisualBasic编码标准.docx（17页珍藏版）》请在冰豆网上搜索。
VisualBasic编码标准
VisualBasic编码标准
沈阳东东系统集成有限公司
1996年7月
目录
1.适用.............................................................................................................1
2.目的..............................................................................................................1
3.环境..............................................................................................................1
4.说明
4.1名称的定义方法..................................................................................1
4.2常量......................................................................................................2
4.3变量型..................................................................................................2
4.4变量名..................................................................................................2
4.5index...................................................................................................3
4.6根据type活用结构说明.....................................................................3
4.7数组的说明..........................................................................................3
4.8在实行时，数组大小的决定...............................................................3
4.9关于Constant.txt..................................................................................3
5.编码
5.1在编码部的方法和属性....................................................................3
5.2Cancel与Default................................................................................3
5.3optionbutton...........................................................................................4
5.4listbox的初始化....................................................................................4
5.5选择按扭................................................................................................4
5.6过程的参数..........................................................................................4
5.7利用DLL时的参数..............................................................................5
5.8向textbox的字符串的赋值.................................................................6
5.9在list/convobox中的ItemData............................................................6
5.10sizeof....................................................................................................7
5.11字符串的连接....................................................................................7
5.12向结构内的字符串变量的赋值........................................................8
5.13应用程序的2次起动时的检测.......................................................8
5.14有关日期check函数（IsDate（））的注意..............................................8
5.15messagebox的mark指定.................................................................9
5.16有关Trim＄的注意...........................................................................9
5.17有关Grid的注意...............................................................................9
5.18关于错误的处理................................................................................9
5.19进行需时较长的处理时的注意......................................................10
5.20在使用FileCopy函数时的注意.....................................................10
6.project
6.1projectfile.............................................................................................10
7.安装
7.1在终端的安装....................................................................................11
8.VCP的利用
8.1file选择对话框...................................................................................11
8.2text输入领域框架...............................................................................11
8.3optionbuttonframe框架.......................................................................11
8.4对需时较长处理的进度状况表示....................................................11
8.5关于利用VCP的Control的窗体的颜色........................................11
9.FEP的control.........................................................................................12
10.cursor移动control]
10.1在return输入时，向下一个输入领域移动...................................12
11.textbox选择处理.....................................................................................13
1.适用
本编码规范记录了在编写VisualBasic的程序时的规范及标准。
2.目的
以软件的标准化、统一化为目的，希望每个人都可以通过此规范进行编码，提高程序的易读性及修改、维护的效率。
3.环境
（1）选择环境
环境设定中的“必须的变量”说明为Yes。
这样就可以对未明确说明的变量进行检测。
环境设定中的“语法检测”设定为Yes。
环境设定中的“既定值的保存形式”设为text。
（见表1）
（2）尽管画面尺寸很大（800*600/1024*768）时可以增加表示的信息量，提高操作性，但是由于不同的机种（如笔记本），有的仅仅支持VGA（600*480）方式，所以在决定画面尺寸时，必须充分考虑运行环境的要求。
（3）显示时颜色越多（如256色），看起来越美观，并且可以灵活使用其它的图形软件，但是这会给Windows的内存资源带来很大的负担。
若只是为单纯的业务使用，基本上设定为16色。
（4）此外，下面还列举了会对资源产生影响的一些因素。
在交货时要对环境做好充分的准备。
①壁纸
②程序管理器内的icon数
③屏幕保护程序
4.说明
4.1命名方法
用前缀（3个文字/小写文字）来标识客体类型。
用其后面的文字表示变量内容。
这一部分的头文字使用大写。
例：
btnStart
（注意VisualBasic不区分大/小写文字。
）
VisualBasic对象命名约定：
对象
前缀
例子
Form
frm
frmStartUp
CommandButton
btn
btnExit,btnHelp
Label
lbl
lblOptions
TextBox
txt
txtHello
Menu
mun
munMain
ScrollBars:
Horizontal,Vertical
hsb,vsb
hsbRate;vsbRate
OptionButton
opt
optPrinter
CheckBox
chk
chkSound
ListBox
lst
lstColors
ComboBox
cbo
cboEmployees
Frame
fra
fraOptions
PictureBox
pic
picMouse
Image
img
imgLightBulb
Panel
pnl
pnlStatus
Shape
shp
shpOval
Line
lin
linDiagonal
timer
tmr
tmrAnimate
DataControl
dtc
dtcTelephone
GridControl
grd
grdDisplay
CommonDialogBox
cmd
cmdFileOpen
4.2常量
常量用大写文字描述。
常量名后必须附上类型说明文字（%，＄等）。
4.3变量型
尽量避免使用变量类型,不如不使用它。
4.4变量名
对于全局变量，要依据Windows标准。
对于局部变量自由设定。
4.5Index
因为Index是保留字，所以不可作为变量名使用。
4.6用Type来进行结构声明
在程序模块的General中声明的变量要尽量用Type集中起来。
4.7数组的说明
DimX（3）AsInteger
采取上述的方式说明时，应注意数组的元素数要作为4个（从X（0）到X（3））来对待，数组的说明最好按照以下的方式明确地记录数组下标的范围。
DimX（0To3）AsInteger
4.8动态数组大小的决定
在何种程度上活用ReDim，正处于研讨中。
4.9关于Constant.txt
要将常量从Constant.txt中挑选出来使用。
VisualBasic的运行形式（EXE形式）同编译程序不一样，将不使用的变量、函数也包含进去了。
因此，要避免按原样INCLUDECONSTANT.TXT，而产生由于有了许多不使用的变量使得模块增大的问题。
5.编码
5.1在编码部的方法与属性
对于当前客体的方法和属性不附加客体名。
（考虑到在客体名不同的程序之间的使用）
使用Me。
例）若编码所属的窗体名为forml时，下述的1）和2）是同样的含义，但由于上叙的理由，请使用2）。
1）FormName＄=forml.Caption
2）FormName＄=Me.Caption
5.2Cancel和Default
若把button的Cancel属性设为True，则在运行程序时按[ESC]键时，进入此button的click事件处理。
若把button的Default属性设为True，则在运行程序时按[Enter]键时，进入button的click事件处理。
在设计书中要明确记录在按[ESC]键及[Enter]键时的处理。
5.3选择按扭
要尽量将选择按扭装载在frame上。
在将多个选择按扭装载在一个frame上时，只有已选的选择按扭成为选择状态，而其它的选择按扭成为非选择状态。
（不需要编码）参照P18页选择按扭和frame的框架图。
5.4listbox的初始化
listbox的内容的初始化在Form_Load事件过程中进行。
SubForm_Load（）
‘Listbox表示
List1.AddItem“indo”
List1.AddItem“America”
List1.AddItem“France”
List1.AddItem“English”
List1.AddItem“日本”
EndSub
5.5选择按扭
利用copy&paste，以控制数组的方式来实现，即每个选择按扭作为控制
数组的一个元素。
（参照P16页的选择按扭和frame框架图）
5.6过程的参数
对于文字列和数组类型的参数按其原样（参照传送），而对于其它的参数按照ByVal说明进行值传送。
按照ByVal说明向过程进行值传送的例子
SubForm_Click（）
DimMsg,SqrN‘变量的说明.
DimNAsDouble
N=InputBox（“请输入值.求该值的平方根.”）
Msg=N&“的平方根“
‘Function调用procedure.
SqrN=SquareRoot（N）
SelectCaseSqrN
Case0:
Msg=Msg&“是0.”
Case-1:
Msg=Msg&“不可计算.”
CaseElse:
Msg=Msg&SqrN&“是.”
EndSelect
MsgBoxMsg‘message的表示.
EndSub
FunctionSquareRoot（XAsDouble）AsDouble
SelectCaseSgn（X）‘调查输入值的符号.
Case1‘为正数时.
SquareRoot=Sqr（X）
ExitFunction
Case0‘为0时.
SquareRoot=0
Case-1‘为负数时.
SquareRoot=-1
EndSelect
EndFunction
5.7利用DLL时的参数
因为所使用的DLL说明全部集中在共同的BAS文件中，所以要注意不要随意地在各个程序中说明。
按照下列方式在过程中记录有公式时，有时会引起不可修复的错误。
（不是发生直接错误，而是在其它地点因关联而死机）
Sts=tbXXXX（left＄（“aaaaa”,4）,”abcddd”）
在调用DLL函数时，一定要先按下列方式代入变量以后再进行。
FileName＄=Left＄（“aaaaa”,4）
Sts=tbXXXX（FileName＄,”abcddd”）
5.8向textbox进行字符串的赋值
向textbox的Text域里输入字符串时，使用Trim＄（）。
在到后面的空白为止输入时，在textbox上的插入就变得无效，因此，若前面的空白有含义时则使用RTrim＄（）
txtXxxxx.Text=Trim＄（YYYY）
5.9在ListBox/ComboBox中的ItemData
在ListBox/ComboBox中，根据ItemData来判断什么被选择了。
因此，在进行AddItem时，要同时设定ItemData。
ItemData,NewIndex属性的例子
以下的程序，做成了表示雇用者一览的listbox,使用了与被排序的list相对应的NewIndex,在排序ItemData中代入雇用者ID。
user所选择的项目的名称和序号在label中表示。
在执行这个例子程序时，在form中装载上listbox和label，在这个form的说明section中，粘贴下面的编码。
然后，将listbox的sorted属性设定为真（true）。
最后在按[F5]键之后，请clicklistbox。
SubForm_Load（）
‘正被排序的List1和ItemData数组
‘按照使其一致的方法进行输入。
List1.AddItem”物部”
List1.ItemData（List.NewIndex）=42310
List1.AddItem“菅原”
List1.ItemData（List1.NewIndex）=52855
List1.AddItem‘藤原”
List1.ItemData（List1.NewIndwx）=64932
List1.AddItem“苏我”
List1.ItemData（List1.NewIndex）=39227
EndSub
SubList1_Click（）
‘在label中表示雇用者ID和雇用者名。
Msg=List1.ItemData（List1.ListIndex）&”“
Msg=Msg&List1.List（List.ListIndex）
Label1.Caption=Msg
EndSub
5.10sizeof
因为不存在sizeof函数，所以用Len或LenB代替它。
Len函数要返回在被指定的字符串中所包含的文字数。
在想求文字列的byte数时，要使用LenB函数。
例）Len函数与LenB函数的区别表示如下。
（A为全角文字）
Sts1=Len（“AAA”）‘在Sts1中，“3”被返回。
Sts2=LenB（“AAA”）‘在Sts2中，”6”被返回。
5.11字符串的连接
在字符串的连接中，“+”和“&”中使用哪一个都可以，但为了避免同加法产生误解，请使用“&”。
&运算符的例子
下列程序使用&运算符，将数值变量（Varl）、空白、及内容为“序号”的字符串Var2进行连接。
在执行此程序例时，在将编码粘贴在form的说明section上之后，在按[F5]键之后请clickform。
SubForm_Click（）
DimVar1,Var2‘变量的说明
Var1=76
Var2=“序号“
MsgBoxVar1&”“&Var2’连接起来显示
EndSub
5.12对结构体内的字符串变量的赋值（profile·access时的注意）
在向被声明为固定长的字符串进行赋值时，字符串长度不够的部分会补以空白，所以考虑到同C语言的接口，按照以下方式进行赋值。
另外，若在数据中包含有双字节的文字时，可能会发生不可修复的错误，作为对策、附加上两个NULL（Chr＄（0））就不会发生了。
TypeAAA
BBBAsString*12
EndType
DimCCCAsAAA
‘对由textbox出来的文字列，要在10个文字以下。
CCC.BBB=Text1.Text&Chr＄（0）&Chr＄（0）
or
CCC.BBB=Text1.Text+String＄（LenB（CCC.BBB）-LenB（Text1.Text）,chr
＄（0））
5.13应用程序2次起动时的检测
为了禁止将程序在同一个终端上重复起动，所以要检查form的instance。
IfApp.PrevInstance＜＞0Then
MsgBox“XXX已经被执行“,MB_OK,ME.Caption
End
EndIf
5.14有关日期检测函数（IsDate（））的注意
本函数本来是用于例如对31日或2/29的存在进行检测的，但要注意如赋给如13/3这样的日期，就会自动地变换为3/13（欧美式日期与日本式日期的变换）并且返回为OK。
5.15messagebox的mark指定
MsgBox（）函数中，用type变量，可指定[stopmark],[question],[惊讶],[information],这种添加mark标记的基准容易产生个人差。
因此就要制作基准来统一，或者以不使用的方式来统一。
5.16有关Trim＄的注意
Trim＄是用来消去字符串前后的空格（&h20）的，不能消
升级会员 