FormRegionStartup.GetFormRegionIcon 方法 (Outlook)
获取一个将为窗体区域的特定类型图标显示的图标图像。
语法
expression. GetFormRegionIcon( _FormRegionName_ , _LCID_ , _Icon_ )
表达 一个代表“FormRegionStartup”对象的变量。
参数
| 名称 | 必需/可选 | 数据类型 | 说明 |
|---|---|---|---|
| FormRegionName | 必需 | String | 在 Windows 注册表中注册窗体区域时使用的窗体区域的名称。 |
| LCID | 必需 | 长整型 | 标识 Outlook 当前使用的语言的区域设置 ID。 此值用于获取与窗体区域的此语言相对应的本地化字符串。 |
| Icon | 必需 | OlFormRegionIcon | 一个标识图标类型的常量。 |
返回值
一个表示图像文件的原始字节的字节数组，或是一个 IPictureDisp 对象的变量。
备注
此方法通过加载项实现，并由 Outlook 调用。 作为 FormRegionStartup 接口的一部分，此方法和 GetFormRegionManifest 方法提供了一种机制，加载项可以通过这种机制注册窗体区域，并为 Outlook 提供 XML 清单和窗体区域图标。
如果您将外接程序来为窗体区域提供的图标，请指定的外接程序的 ProgID，当您在 Windows 注册表中注册窗体区域。 注册窗体区域的详细信息，请参见在 Windows 注册表中指定窗体区域。 外接程序必须实现 GetFormRegionManifest 和 FormRegionStartup 接口的 GetFormRegionIcon 方法。
窗体区域下 图标 元素, 的 XML 清单中指定为每个您想要使用的自定义图标的子元素的值 addin 。 实现 GetFormRegionIcon ，以便在 Outlook 传递该类型的图标作为 Icon 的参数时， GetFormRegionIcon 返回自定义图标的图像。 如果希望 Outlook 显示默认图标，请实现 GetFormRegionIcon，以便它为这种类型的图标返回 null（在 Visual Basic 中为 Nothing）。 当 Icon 为 olFormRegionIconDefault 时，GetFormRegionIcon 还应返回 null (Visual Basic) Nothing。
当 Outlook 启动时，它会从 Windows 注册表中读取列表中的窗体区域并缓存的窗体区域相关联的数据。 如果窗体区域中注册一个 ProgID，Outlook 将借助相应外接程序通过调用 GetFormRegionIcon 其实现了 addin作为 图标 元素的子元素的值的 XML 清单中的任何图标。 请注意，如果未在 Windows 注册表中指定任何 ProgID，Outlook 将不会调用 GetFormRegionManifest 和 GetFormRegionIcon 方法。
另请参阅
支持和反馈
有关于 Office VBA 或本文档的疑问或反馈？ 请参阅 Office VBA 支持和反馈，获取有关如何接收支持和提供反馈的指南。