使用加载项指定窗体区域的图标

使用加载项指定想要用于帮助识别资源管理器、检查器和功能区中项的状态的自定义图标。 通过用于注册窗体区域的窗体区域清单 XML 文件,可以指定扩展窗体区域的加载项,以及要使用自定义图标的情况。 当指定情况发生时,Outlook 将从加载项中获取相应的图标。

使用加载项指定窗体区域的图标

  1. 实现 FormRegionStartup 接口。

    扩展窗体区域的所有加载项都必须实现 FormRegionStartup 接口。 Outlook 调用此接口以获取窗体区域的布局存储数据。 有关窗体区域加载项的详细信息,请参阅 使用外接程序扩展窗体区域

    具体而言,若要指定自定义图标,外接程序实现 FormRegionStartup 接口的 GetFormRegionManifestGetFormRegionIcon 方法,指定窗体区域清单 XML 文件以及 Outlook 应在资源管理器、检查器或功能区中显示自定义图标的情况。 例如,可以创建一个窗体区域来显示仅在家庭中发生的任务类型,并且这些家庭任务属于消息类 IPM。Task.Household,派生自 IPM。任务。 可以使用加载项扩展窗体区域,该加载项在 GetFormRegionIcon 方法中指定 Outlook 应显示在资源管理器中经常性的家庭任务旁边的特殊定期图标。

  2. 在窗体区域清单 XML 文件中,在 icons 元素下指定要在其中使用自定义图标的每个子元素的值 addin

    当 Outlook 在资源管理器或检查器中显示项目时,Outlook 会在缓存中查找与特定邮件类的项目关联的窗体区域清单。 如果 icon 元素的子元素具有 值 addin,Outlook 会调用 GetFormRegionIcon 以获取相应的图标,并相应地显示该邮件类的项。

    作为最后一个示例的扩展,在窗体区域清单中,与 IPM 关联的窗体区域的 XML 文件。Task.家庭,可以在 icons 元素下指定定期子元素的值addin。 当 Outlook 在资源管理器中显示所有任务时,Outlook 将查看属于 IPM 的项目的缓存窗体区域清单 。Task.Household。 当 Outlook 意识到 定期 元素具有 值 addin时,Outlook 将调用 GetFormRegionIcon 以获取经常性家庭任务的图标,并在浏览器中显示与此类任务相邻的特殊重复图标。 有关 icons 元素的子元素的详细信息,请参阅 如何:指定要为窗体区域显示的图标

支持和反馈

有关于 Office VBA 或本文档的疑问或反馈? 请参阅 Office VBA 支持和反馈,获取有关如何接收支持和提供反馈的指南。