命名的学问
为类模块及其属性、方法和事件选择的名字组成了访问该部件的接口。在给这些元素及其参数命名时,应当遵循以下的简单规则,以方便使用该部件的用户。
- 尽可能使用完整的单词,例如“SpellCheck”。缩写可以有多种形式,因此会引起混乱。如果整个单词太长,就使用其完整的第一个音节。
- 使用大小写混合来命名标识符,将每个单词或音节的首字母大写,例如 ShortcutMenus 或 AsyncReadComplete。
- 描述一个概念时,选择用户可能会使用的单词,例如,使用 Name 而不是 Lbl。
- 使用恰当的复数形式给集合类的名字命名,例如 Worksheets、Forms、或 Widgets。如果集合所包含的对象的名字是以“s”结尾,则在名字后添加 Collection,例如 SeriesCollection。
- 可以按照本章后面“给部件提供命名的常数”中的介绍,在命名枚举常数时使用前缀。
- 使用一致的动作/对象或对象/动作的顺序给方法命名。即使用 InsertWidget、InsertSprocket 等,或者总是将对象放在前面,如 WidgetInsert 和 SprocketInsert。
重要 不能把下列名称当作属性名或方法名来用,因为它们都属于下一级的 IUnknown 和 IDispatch 接口: QueryInterface、 AddRef、 Release, GetTypeInfoCount、 GetTypeInfo、 GetIDsOfNames 和 Invoke。使用这些名称将导致编译错误。
详细信息 该列表的扩充版本位于“ActiveX 部件的标准及指南”的“对象命名指南”。