FormRegionStartup.GetFormRegionManifest 方法 (Outlook)
获取窗体区域的 XML 清单。
语法
expression。 GetFormRegionManifest( _FormRegionName_ , _LCID_ )
表达 一个代表“FormRegionStartup”对象的变量。
参数
| 名称 | 必需/可选 | 数据类型 | 说明 |
|---|---|---|---|
| FormRegionName | 必需 | String | 在 Windows 注册表中注册窗体区域时使用的窗体区域的名称。 |
| LCID | 必需 | 长整型 | 标识 Outlook 当前使用的语言的区域设置 ID。 此值用于获取与窗体区域的此语言相对应的本地化字符串。 |
返回值
表示窗体区域 XML 清单 Variant 。 该 XML 字符串包含窗体区域，如显示名称 (按照指定的标题元素)、 任何相关的布局文件或外接程序中，任何受支持的用户操作和任何本地化字符串的特征。 XML 必须按照窗体区域 XML 架构。 有关窗体区域 XML 架构的详细信息，请参阅 MSDN 库中Microsoft Outlook 2010 XML 架构参考。
备注
此方法应由加载项实现并由 Outlook 调用。 作为 FormRegionStartup 接口的一部分，此方法和 GetFormRegionIcon 方法提供了一种机制，加载项可以通过这一机制注册窗体区域，并向 Outlook 提供窗体区域的 XML 清单和图标。
如果您希望外接程序提供一个窗体区域 XML 清单，指定 ProgID的外接程序，当您在 Windows 注册表中注册窗体区域。 有关注册窗体区域的详细信息，请参阅在 Windows 注册表中指定窗体区域。 外接程序必须实现 FormRegionStartup 接口的 GetFormRegionManifest 方法。 请注意，如果未在 Windows 注册表中指定任何 ProgID ，Outlook 将不会调用此方法。
依靠外接程序提供一个窗体区域的 XML 清单也意味着您允许外接程序为该窗体区域提供的任何图标。 外接程序必须实现 FormRegionStartup 接口 GetFormRegionIcon 。 Outlook 将调用 GetFormRegionIcon 来获取任何外接程序中指定的图标的窗体区域。 有关使用加载项指定图标的详细信息，请参阅操作方法：使用加载项指定窗体区域的图标。
当 Outlook 启动时，它会从 Windows 注册表中读取列表中的窗体区域并缓存的数据。 根据这些数据，如果 Outlook 注意外, 接程序已指定要为窗体区域提供的 XML 清单，Outlook 将使用 ProgID中的缓存的数据和调用 GetFormRegionManifest 方法实现由该外接程序获取它需要显示窗体区域 XML 提供。 如果 XML 清单无效并且不符合窗体区域 XML 架构，Outlook 将不能加载窗体区域。 此外，如果未在 Windows 注册表中指定任何 ProgID ，Outlook 将不会调用 GetFormRegionManifest 和 GetFormRegionIcon 方法。
当加载项提供 XML 清单时，Outlook 会忽略以下元素：
name ：Outlook 忽略为此元素指定的值，并将使用为注册表中的窗体区域指定的名称。
layoutFile ：Outlook 忽略此元素，因为外接程序正在扩展此窗体区域。
addin ：Outlook 使用注册表中 () 前面带有等号 = 的值作为加载项的 ProgID 。
stringOverride 的 file 属性：Outlook 忽略 stringOverride 元素指定的任何辅助本地化文件。 加载项可以实现 GetFormRegionManifest 以内联返回指定 LCID 字符串本地化的 XML 清单，或者以其他方式管理字符串本地化，例如，使用.NET Framework本地化，然后返回指定 LCID 的相应 XML 清单。
另请参阅
支持和反馈
有关于 Office VBA 或本文档的疑问或反馈？ 请参阅 Office VBA 支持和反馈，获取有关如何接收支持和提供反馈的指南。