还剩7页未读,继续阅读
文本内容:
请在这里输入公司名称文档编号产品版本密级XK-DN-2000-10-11-05V
1.0内部产品名称共页软件界面设计及编码标准规范仅供内部使用文档作者____________________日期___/___/___开发/测试经理____________________日期___/___/___产品经理____________________日期___/___/___管理办____________________日期___/___/___请在这里输入公司名称版权所有不得复制电能质量数据分析软件界面设计及编码标准规范文档修改记录版本号日期所修改页注记1.02000/10/158常见快捷键规定目录TOC\o1-3
一、开发环境3
二、软件界面设计标准规范32.1编写目的32.2内容
32.
2.1界面设计思想
32.
2.2界面设计原则
32.
2.3界面设计样式
32.
2.4常见提示信息样式
32.
2.5常见错误信息样式
32.
2.6其他界面约定3
三、软件编码设计标准规范33.1.编写目的33.2内容33.2.1对象命名约定33.2.2常量和变量命名约定33.2.3结构化编码约定33.2.4数据源的约定33.2.5数据库访问约定33.2.6其他约定3
一、开发环境NT
40、WIN98作开发操作平台前台采用此处输入开发工具名称作开发工具,后台以(此处输入数据库名称)作数据库来管理数据存储屏幕分辨率800*600大字体,可在程序启动后自动设定
2、软件界面设计标准规范2.1编写目的当今软件界的所有软件无不是可视化的用户界面,它的好处不外乎它有美观、直接、操作者易懂和操作方便等好处(此处输入编写文档的具体目的)2.2内容
2.
2.1界面设计思想“为用户设计,而不是设计者”
2.
2.2界面设计原则
(1)界面要美观、操作要方便并能高效率地完成工作
(2)界面要根据用户需求设计
(3)界面要根据不同用户的层次设计(有的用户对计算机相当了解而有的从来就没碰过计算机)
(4)避免出现嵌套式的界面设计
(5)界面和代码要相互制约
(6)界面要通“人性”即要有引导用户操作的功能,不能是操作一有误就卡住什么都做不下去,又无任何提示来帮助用户如何进行操作
2.
2.3界面设计样式1登录界面(此处加入登陆界面图)
(2)系统功能布局菜单形式(此处加入界面图)标签栏形式(此处加入界面图)
(3)录入界面(此处加入界面图)
(4)查询界面(此处加入界面图)
(5)统计界面(此处加入界面图)
2.
2.4常见提示信息样式
(1)当操作会带来严重后果时(默认按钮为“否“)(此处加入界面图)
(2)当操作会带来一定后果时(默认按钮为“否“)(此处加入界面图)
(3)当需征求操作者意愿时(默认按钮为“是“)(此处加入界面图)
(4)当需提供操作者帮助时(此处加入界面图)
(5)当操作者操作有错时(此处加入界面图)
(6)当是一般提示时(此处加入界面图)范例(此处加入界面图)
2.
2.5常见错误信息样式(此处加入界面图)
2.
2.6其他界面约定字体一般界面字体为宋体,字号为9Twip(只要把窗体字体设为宋体,字号为9twip即可)颜色界面颜色采用默认色(除非用户有特殊要求)按钮高度375Twip,除“确定”和“取消”外都需含有快捷键常见按钮快捷键添加A、删除D、查询S、更新U、打印P、关闭C、重新查询R、统计T、退出E数据REAL型数据一律保留两位小数且右对齐对齐方式界面上的标题(Label)右对齐,其他控件左对齐参考文献(此处加入参考文献)
三、软件编码设计标准规范3.1.编写目的使用统一编码约定集的主要原因,是使应用程序的结构和编码风格标准化,以便于阅读和理解这段编码好的编码约定可使源代码严谨、可读性强且意义清楚,与其它语言约定相一致,并且尽可能的直观一组通用目的的编码约定应该定义完成上述目的所必需的、能让程序员自由地创建程序逻辑和功能流程的最小的要求编码约定的目的是使程序易于阅读和理解,而不是用过份的约束和绝对的限制来束缚程序员本身的创造性3.2内容程序设计语言的特性和风格会直接影响到软件的质量和可维护性编码原则应尽量避免在系统初始化时运行过多的代码(此处加入详细原则)
(1)选用控制结构只准许一个入口和一个出口
(2)程序语句组成容易识别的块,每块只有一个入口和一个出口
(3)复杂的结构应该用基本控制结构进行组合嵌套来实现
(4)语句中没有的控制结构,可用一段等价的程序段模拟,但要求该程序段在整个系统应前后一致
(5)严格控制GOTO语句,仅在下列情形才可使用用一个非结构化的程序设计语言去实现一个结构化的构造在某种可以改善而不是损害程序可读性的情况下3.2.1对象命名约定公式对象名称=对象前缀+自定义名称(自定义名称要有一定的意义且第一个字母大写)说明如果是不需要对其编码的对象,那么对象名用默认对象名应该用一致的前缀来命名对象,使人们容易识别对象的类型下面列出了Delphi支持的一些推荐使用的对象约定
(1)推荐使用的项目前缀控件类型前缀例子ClassModulecmdlcmdlCheckDataEnvironmentdevdevPrintsDataReportdrtdrtEnglishFormfrmfrmEntryMDIFormmfrmmfrmSinoexportModulemdlmdlConnectionProjectpjtpjtCkmis
(2)推荐使用的控件前缀控件类型前缀例子3DPanelpnlpnlGroupADODataadoadoBiblioAnimatedbuttonanianiMailBoxCheckboxchkchkReadOnlyComboboxdrop-downlistboxcbocboEnglishCommandbuttoncmdcmdExitCommondialogdlgdlgFileOpenCommunicationscomcomFaxControl(当特定类型未知时,在过程中所使用的)ctrctrCurrentDatadatdatBiblioData-boundcomboboxdbcbodbcboLanguageData-boundgriddbgrddbgrdQueryResultxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
(3)推荐使用的数据访问对象的前缀用下列前缀来指示数据访问对象数据库对象前缀例子ConnectionconconReportsxxxdbdbAccounts一些例子(此处加入例子)
(4)推荐使用的菜单前缀应用程序频繁使用许多菜单控件,对于这些控件具备一组唯一的命名约定很实用除了最前面mnu标记以外,菜单控件的前缀应该被扩展对每一级嵌套增加一个附加前缀,将最终的菜单的标题放在名称字符串的最后下表列出了一些例子菜单标题序列菜单处理器名称(此处加入标题序列及处理器名称)当使用这种命名约定时,一个特定的菜单组的所有成员一个接一个地列在VisualBasic的“属性”窗口中而且,菜单控件的名字清楚地表示出它们所属的菜单项
(5)为其它控件选择前缀对于上面没有列出的控件,应该用唯一的由两个或三个字符组成的前缀使它们标准化,以保持一致性只有当需要澄清时,才使用多于三个字符的前缀例如,(此处加入例子)3.2.2常量和变量命名约定公式常量或变量名称=常量或变量范围前缀+常量或变量类型前缀+自定义名称(自定义名称要有一定的意义且第一个字母大写)除了对象之外,常量和变量也需要良好格式的命名约定本节列出了(此处加入变量列表)变量应该总是被定义在尽可能小的范围内全局Public变量可以导致极其复杂的状态机构,并且使一个应用程序的逻辑非常难于理解全局变量也使代码的重用和维护更加困难Delphi中的变量可以有下列范围范围声明位置可见位置过程级(此处加入名称)模块级(此处加入名称)全局(此处加入名称)较好的编码习惯是尽可能写模块化的代码例如,如果应用程序显示一个对话框,就把要完成这一对话任务所需要的所有控件和代码放在单一的窗体中这有助于将应用程序的代码组织在有用的组件中,并减小它运行时的开销除了全局变量(应该是不被传递的),过程和函数应该仅对传递给它们的对象操作在过程中使用的全局变量应该在过程起始处的声明部分中标识出来变量范围前缀随着工程大小的增长,划分变量范围的工作也迅速增加在类型前缀的前面放置单字母范围前缀标明了这种增长,但变量名的长度并没有增加很多范围前缀例子全局gGstrUserName模块级mMblnCalcInProgress本地到过程无DblVelocity(此处加入说明)变量声明所有的变量将会(此处加入说明)应该给变量加前缀来指明它们的数据类型而且前缀可以被扩展,用来指明变量范围,特别是对大型程序变量数据类型用下列前缀来指明一个变量的数据类型(此处加入说明)描述变量和过程名变量或过程名的主体应该使用大小写混合形式,并且应该足够长以描述它的作用而且,函数名(此处加入函数名称)对于频繁使用的或长的项,推荐使用标准缩略语以使名称的长度合理化一般来说,(此处加入特例说明)就困难了当使用缩略语时,要确保它们在整个应用程序中的一致性在一个工程中,如果一会儿使用(此处加入说明问题),将导致不必要的混淆用户定义的类型在一项有许多用户定义类型的大工程中,常常有必要给每种类型一个它自己的三个字符的前缀如果这些前缀是(此处加入前缀名称)3.2.3结构化编码约定(此处加入约定说明)记住下列几点每一个重要变量的声明应该包括(此处加入变量名称)
(2)格式化代码因为许多程序员(此处加入问题)(此处加入解决问题的说明)
(3)给常量分组变量和定义的常量应该按功能分组,而不是分散到单独区域或特定文件中
(4)运算符(此处加入运算符列表及说明)
(5)为(此处加入问题)查询创建字符串(此处加入说明)3.2.4数据源的约定(此处加入数据源的约定)3.2.5数据库访问约定访问数据库用ODBCdrivers/ADO,但如果在有的技术ADO解决不了的情况下可用其他方法数据库访问技术有(此处加入说明)3.2.6其他约定
(1)当日期、时间型数据要求严格时,(此处加入说明)
(2)记录集应用约束(此处加入约束)利用记录集(此处加入记录集说明)
(3)文件命名约定工程文件和各模块文件以汉字命名保存,这样可方便管理和查找参考文献(此处加入参考文献)。