山西光远科技有限公司-软件开发人员手册

山西光远科技有限公司-软件开发人员手册内容摘要：

类型，名称主体应当使用大小写混合方法，以便于阅读，而且其长度要根据描述其目的的需要来决定。 例如： bIsDirty 和 msUserName。 表 列出常用的变量前缀。 确定一组标准的前缀，可以改进应用程序中的变量命名。 表 常用的变量前缀 前缀 作用域说明 g 全局变量 m 模块级变量 局部变量（没有附加的前缀） st 静态变量 续表 常用的变量前缀 15 前缀 作用域说明 b 布尔型 c 贷币型 64 位 d 双精度 64 位有符号变量 db 数据库型 ds 动态集合（ Dynaset） dt 日期 +时间 f 浮点 /单精度 32 位有符号的浮点型 l 长整型 32 位有符号 i 整型 s 字符串型 v 变体型 a 数组 用户定义类型 匈牙利命名法在 Visual Basic 中就像在 C 语言中那样有价值，因为单靠Visual Basic 类型后缀，不可能提供有关变量用于什么或它在什么地方可被访问的标准信息。 例如： iSend（它可能是发送消息的次数）， bSend（它可能是决定最后一次发送操 作成功与否的布尔变量）， cSend(它可有是寄出的钱数 )都简略地告诉程序员一些截然不同的含义。 当名称减短到 Send%时，这种信息就完全丢失了。 在变量名称中带有作用域名称，也有助于保证你正确地使用变量。 由Visual 中的数据强制机制，如果你不注意变量类型，你会得到预料不到的结果。 *关键注释： 请使用 Option Explicit 以强制适当的变量说明，查找键入错误丢掉的时间，比说明变量所需的时间要多得多。 16 常量常名 常量遵循与变量相同的基本命名约定。 然而常量称的主体用带下划线（“ _”） 的大写字母表示。 例如： miCONTACT_LIST_MAX 代表模块级整型变量，它规定表内填写联络登记数所允许的最大值。 4 用户界面设计原则 什么是一个“好的”用户界面设计。 一个能够使用户顺利地完成日常工作且能满足业务需求的用户界面才是一个“好的”界面。 相反，一个由于信息过多而分散用户的精力、功能不突出或其它原因而降低用户完成工作的效率的用户界面被认为是一个“坏的”界面，或者说得好听点是一个“难用的”界面。 如何设计用户界面。 这里只能说明一些基本的步骤，供大家参考。 要设计好的用户界面，一个重要的条件是不断学 习，观摩优秀的软件，并认真体会别人的设计。 （ 1） 确定用户目标 （ 2） 确定软件功能 （ 3） 提供一个与现实世界一致的模型 一个应用软件应提供给用户一个内心的模型，一种以用户所熟悉的事物来思考应用软件的方法，这样才能使应用软件对用户有意义。 例如， Microsoft Word 在屏幕上提供一张你可在上面打字的纸，它好比机上一张。 Microsoft Excel 则给出一个屏幕上的电子表格，它符合纸质表格内心模型。 提供一个好的内心模型，可以使用户凭直觉把熟悉的知识应用于某种不熟悉的环境中去。 当一个初学计算机的人 使用 Microsoft Word 时，他通常可以接受 E 的模型并开始键入文字。 17 在你对应用软件的主要功能和次要功能有了明确的概念之后，并在你开始把这些功能设计到用户界面之前，要考虑一下对你的应用有意义内心模型。 它不应当是物理上的比喻，而应当是在观察你的应用软件方面具有内在联系的想象。 然后你就可以在设计屏幕的布局方案时着重强调这个内心模型。 （ 4） 功能布局 所有用来完成主要任务的功能都应当放在手边，而其它的功能则要放在不碍事的地方。 主要功能应放在显著位置，次要的功能应易于访问，要有条理地放进菜单中。 （ 5） 屏幕 布局 在设计屏幕布局方面，把注意力集中在应用软件的需求上是很重要的。 要给组件的适当的强调和均衡。 应当让与用户安交互最多的那部分屏幕立即能显示，并且将它放在标记顺序的最始端。 相关信息的集合应被设计成为一可视群组，以便帮助用户查找并借助这些信息工作。 屏幕不能太拥挤或难读。 屏幕布局要有条理、高效率。 这样才能帮助用户迅速找到所需的功能和信息，而忽略那些不太要紧的东西。 （ 6） 增加一些信息 在完成功能设计之后，要增加一点信息。 这有助于应用软件观看起来有意思，而且对于一个必须整天盯着屏幕的用户来说特别重要。 在应用软件 中添加图标以使每个对象形象化，每当访问有关对象时，就可以使用它的图标。 可以用简单的线条来提供细节或用它分离屏幕上的不同部分。 也可以用给你的设计加些不突出的背景位图，以使得屏幕更引人注目。 用户界面设计基本原则 遵循这些基本原则，将帮助你设计出一个满足最一般的用户要求的用户界面。 （ 1） 保持简单 当你考虑应用软件的功能并将它们添加到用户界面中去的时候，一定要使主要功能简单，即使它意味着会使次要功能变得更复杂。 不要因为扩大用得 18 最频繁的功能的范围，以致把次要功能也包括进去，而使主要功能失去简易性。 例如，可将 “联络管理器”窗口变成一个允许访问各个联络记录、通迅录或者待完成任务表的标志提示对话框。 这样就会使“联络管理器”窗口变得复杂起来，并且使用户不能同时观看通讯录信息和“联络管理器”窗口。 当事情确实需要变得更复杂时，可用一种叫做逐步暴露的技术来帮助用户处理复杂情况。 这一技术就是大量地把用户所看到的信息组织或限制在当时能适用的范围内。 举个简单的例子：当没有联络记录被选择时，就没有东西需要删除，因此，删除键会是灰色的。 将主要性能保持在尽可能简单的程度上，就意味着你在帮助用户更切实有效地完成他们的主要工作。 （ 2） 提供答案，而不是发问 当设计组在讨论用户界面的选择方案时，最容易的作法往往是说“让用户去决定”，而自己不作出决定。 于是，应用软件各个部分变成了一系列的发问或是一连串需要用户拿主意的选择设置。 这看起来好像设计组给用户提供了很大的灵活性，实际上在许多情况下这只能把用户给搞糊涂了，同时也表明了设计组没有能力进行决策。 例如，联络管理系统的项目组无法决定是用电子数据表格式还是用对话框来输入联络信息。 他们考虑让用户来决定。 于是当用户第一次开始使用应用软件时（或者更糟，在安装过程中），屏幕上会向用户提出一个问题：“是 将联络数据以电子数据表格式出现，还是使用一个对话框。 ”然而，这时用户对于这两个答案的含义却一无所知。 用户会想：“如果是将联络数据以电子数据表格形式输入，那么这是不是说我把数据像在 Excel 中那样输入呢。 ”“什么叫‘使用一个对话框’呢。 ”“如果我作出回答，这个回答是永久性的呢，还是可以改变的呢。 ” 要给用户提供答案而不是提出这类问题，因为这将使他们的脑子里产生更多的问题。 要仔细思考选项，并给选项一个数据输入机制。 如果用户确实需要选择，那么就挑出一项作为缺省项，当用户需要时可以去改变它。 这样一来，用户可以在不用 知道有个选择的情况下使用应用软件。 但是，如果他们需要选择的话，也能找到它。 对数据输入屏幕中所提出的问题也应使用同样的思路。 即确保问题有意 19 义。 尽可能给用户提供一个缺省答案，并允许他们对此进行修改。 当你在“联络管理器”窗口上创建一条新的联络记录时，缺省值将是当前的日期和最近的联络类型，这就缩短了创建一条新登记录所需要的时间。 （ 3） 提供灵活性 用户不可能总是按照你所期望的那样去做事情。 这并不是说他们这样做不对，只能说明他们是人。 计算机不能强迫用户按照它的固定方式工作，而当用户偏离此方式时计算机就用啸叫表示“回 答错误”。 使用应用软件应该没有正确方法或错误方法之分。 关键注释： 一天的工作不断被打断并且充满了不可预料的要求。 软件应该提供灵活性，以使任务与任务之间，一个单项任务的每个步骤之间可以互相转换，而不会产生模糊的错误信息。 它应提供多种的导向方法以使不同的操作之间可以顺利地互相转换。 保证软件能够处理用户必须完成的不同类型的工作。 还记得项目组在以目标为中心设计里，为应用软件确定的方案吗。 正如上面所描述的那样，应确保这方案能随机且有效地使用各种功能。 它要有在一组功能步骤中间被中断、然后再回溯到被中断处继续工作的 能力。 给应用软件提供这样的灵活性，就使它能更好地适应用户通常完成他们任务的方式。 （ 4） 营造一个宽松的环境 软件开发人员真正关心的是应用软件所保持的数据的准确性。 他们有时把这一点说成每一个字段都要仔细控制，而用户在每一步操作之前也都要加以校核以保证它的正确性。 让我们再来看看联络管理系统应用软件的设计。 当用户正在输入一个新的电话联络信息时，另一个电话打了进来，这时用户想要在不结束第一个电话登录的情况下建立一个新记录。 请试想一下，如果软件反回信息显示“联络人地址字段不能是空白的”用户该有多么扫兴。 于是用户飞 速填好前一个联络地址，然后再试着建立另一个新的记录（所有这些都是在与新打来电话的客户的交谈中进行的），而软件响应的另一个信息框却显示：“联络人的类型必需是数字。 ” 用户在恼怒之下敲击删除键，但是由于这个追加项从来没有被完成过，因此软件的响应为“找不到联络人。 ” 20 这时候，用户会变得非常恼怒，一气之下关掉计算机。 所以，应用软件为了保持数据绝对准确的高标准防碍了用户完成他们的工作。 而另有一些情况显然有必要仔细确认数据，例如你在为一个核电站进行计算时，你就要保证数据是正确的。 关键注释： 在大多数情况下，应用软件可 以更宽容些。 如果用户没填满所有的数据输入字段，它仍应是一个可被接受的输入。 如果用户的一个操作可能导致其它一些副作用，要使操作结果可见并且可以改回去。 这样，用户就可以看到错误所在并能很容易地将其纠正过来。 例如，校核的错误信息可以在不打断用户工作以及不影响记录被存储的情况下显示在屏幕上。 以组合框或单选钮方式来代替所须数值的输入，你可以使数据错误的概率减少到最小。 例如，你可以用单选钮来代替输入“ T”或“ F”的要求。 这样你就无须对输入进行校核，也不会在校核结果是“错误”时显示消息框了。 如果你确实需要提供一个消息 框，应提供对用户有帮助的信息，帮助用户识别问题并且指导他们解决问题。 不要给用户显示太专业化或毫无意义的信息。 便如：“文件索引机制中的致命错误”可改为“你键入的联络人已经存在”。 如果需要一个有关错误的技术性信息，就将错添加到系统记录文件中去。 要把你的校核设计得能满足用户的真正目标。 将可能出现的错误减到最小。 当用户确实做了一个不期望的登录时，应提供一个明确的方法来纠正它。 总之，要让应用软件显得更为宽容。 （ 5） 使其自动记忆 计算机擅长记忆。 如果数据被写入一个永久存储装置，计算机将记住它。 应用软件应该利用 计算机的记忆功能使用户工作得更切实更有效。 你有过这样的经历吗。 用一个对话框去找出在一特定路径里的文件，然后，过一会儿又回到这个对话框去找同一路径里的另一个文件。 这时应用软件是记住你原来所选的路径，还是返回一些无用的默认值呢。 重新定义全部路径是令人失望的事情。 下面是你的应用软件应该记住的有关事项： 最后打开的文件。 最后几个打开的文件，通常是四个，常被列在应用软 21 件的文件菜单内。 这给用户提供了一个快捷地选择和打开某个文件的方法，而无需记住文件在哪里或叫什么名字。 窗口位置。 一般来说，用户一天接一天地用相似的方 式来运行应用软件。 每天用户会打开你的应用软件并将窗口移动到想要的位置。 代替这种重复操作，应用软件可以记住最后的窗口位置，并在缺省状态下把窗口放到这些位置上。 分类选择。 如果用户为数据选择了一个特殊的分类方法、过滤器或其它排列方式。 那么应用软件应该记住它。 当再次访问这一类数据时，它们应该使用相同的排列方式。 让应用软件使用计算机的一些记忆功能，可以显著提高用户的工作效率。 （ 6） 使其信任用户 应用软件常常不信任用户。 试设想如下的情形：让你的秘书将一叠信件存档，而她问你：“你真要保存这些吗。 ”，当然你想要把它们 存储起来，否则就不会这样要求了。 又如，你花了一小时的时间与设计组讨论说明书的变更。 在会议结束时，设计组问你：“你真要保持所有这些变更吗。 ”；再如，当你在一天工作之后走出在大门时，保安员拦住你并问：“你真要走吗。 ”你看这有多荒唐可笑，但是应用软件总是这样做。 在很多应用软件里，每当用户作些变更时就会被问：“数据变更了，你要保存吗。 ”。 那么，如果用户没有变更数据，它就用不着保存吗。 应用软件应该能够清晰可见地让人看到变更了什么，自动存储这一变更（相信用户是打算做出变更的），并且假如用户不想进行变更还允许取消它。 应用软件应该信任用户。 （ 7） 使其适合运行环境 你可曾看到过这样一种房间：虽然设备一流，但设计得却不令人舒适或便于交谈。 你走进这样的一个房间，会害怕碰坏了什么东西，这些房间使你感到不舒服。 同样，对于一个未能根据其运行环境正确设计的软件也是如此。 为了使用户用起你的软件时感很舒服，软件必须恰好符合其运行的环境。 当开发一个 Windows 应用软件时，你的应用软件符合 Windows 应用软件的准则是很重要的。 DOS 程序设计人员们说，他们不想要现有的用户重新学习他们的产品，所 22 以，他们使用同样的用户界面，并且只是将它移植 到 Windows 环境下。 这些应用软件的用户对他们很不满。 为什么那些用户想要一个。