在 属性 窗口的底部,声明区域显示信息与选定的特性字段相关。 默认情况下此功能将打开。 如果您希望隐藏说明字段,右击 属性 窗口并单击 声明。 执行在菜单窗口中 声明 标题旁边因此还移除选中标记。 可以通过执行相同的步骤切换 声明 以重新显示该字段。
在声明字段的信息来自 ITypeInfo。 每个方法,接口, coclass,依此类推可以有在类型库中未本地化的 helpstring 属性。 属性 中的 GetDocumentation检索该字符串。
指定本地化的帮助字符串
添加 helpstringdll 特性添加到类型库 (typelib) 的库语句。
备注
此步骤是可选的,如果类型库在对象库 (.olb) 文件。
指定字符串 helpstringcontext 属性。 还可以指定 helpstring 属性。
这些属性从 helpfile 和 helpcontext 属性是不同的,在实际 .chm 文件帮助主题包含。
若要检索为所显示的属性名称中显示的声明信息, 属性 窗口调用选定的属性的 GetDocumentation2 ,指定预期 lcid 属性为输出字符串。 在内部, ITypeInfo2 在 helpstringdll 属性查找 .dll 文件指定并调用在的 DLLGetDocumentation 具有指定的上下文和 lcid 属性的 .dll 文件。
DLLGetDocumentation 的签名和实现为:
STDAPI DLLGetDocumentation
(
ITypeLib * /* ptlib */,
ITypeInfo * /* ptinfo */,
LCID /* lcid */,
DWORD dwCtx,
BSTR * pbstrHelpString
);
DLLGetDocumentation 函数必须是在 DLL 的 .def 文件中定义的导出。
在内部,实际上是 DLL 的 .olb 文件中创建。 此 DLL 包含资源、类型库 (.tlb) 文件和一个导出函数, DLLGetDocumentation。
对于 .olb 文件, helpstringdll 特性是可选的,因为它是包含 .tlb 文件相同的文件。
显示获取字符串。 声明 窗格,因此,您必须执行的最小值是指定 helpstring 属性在类型库。 如果您希望这些字符串本地化,必须指定 helpstringdll (可选) 属性和 helpstringcontext (必需) 属性并实现 DLLGetDocumentation。
不需要实现,在获取本地化的信息通过 IDL 中 helpstringcontext 属性和 DLLGetDocumentation时的其他接口。
获取属性的本地化名称和说明的另一种方法是通过实现 GetLocalizedPropertyInfo。 有关此方法的实现的相关更多信息,请参见 " 属性 " 窗口字段和接口。