指定要为窗体区域显示的图标
为自定义邮件类(如 IPM.Note.Customer)定义窗体区域时,可以指定要在浏览器、检查器和功能区中为属于该邮件类的项目显示的自定义图标。
图标指定为 Win32 资源 DLL 文件中的资源。 请参阅标准 Win32 嵌入图标表示法中的图标文件。 例如:
<default>c:\myicon.ico<.default>
从指定路径 c:\ 加载默认图标<unread>c:\myresource.dll,101</unread>
从指定路径 c:\ 中的资源文件 myresource.dll 加载资源 ID 为 101 的图标资源
请注意,可以在文件路径名称中指定环境变量,但不能使用通用命名约定 (UNC) 指定路径。 默认情况下,如果未指定任何自定义图标,将使用分配给父消息类的图标。 例如,如果未为 IPM 的窗体区域指定任何图标 。Note.Customer,然后是 IPM 的图标。将使用注释 。
项目可能处于不同的状态(取决于项目的类型),可以考虑使用单独的图标来区分这些状态。 例如,在资源管理器中,任务项可以使用自定义图标将自身标识为定期任务,邮件项可以使用自定义图标将自身标识为已答复。 不必为项目类型可以处于的每个状态指定单独的图标;可以选择指定默认图标,该图标将显示在适用于该项类型的资源管理器、检查器和功能区中的所有状态中。
下表显示了项目的各种状态,可以考虑在浏览器、检查器或功能区中使用自定义图标来标识这些状态。 窗体区域的所有自定义图标都在该窗体区域的窗体区域清单 XML 文件中的 icons 元素下指定。 每种状态都与 icons 元素的一个 XML 子元素对应。 在 Windows 注册表中注册窗体区域时,你将指定此窗体区域清单 XML 文件。 有关注册窗体区域的详细信息,请参阅在 Windows 注册表中指定窗体区域。
项目的状态 | XML 子元素 | 示例 |
---|---|---|
适用于项目的任何状态(如果没有为该状态定义任何其他自定义图标)。 | default | <default>c:\default.ico</default> |
用来在浏览器中标识该项目已加密的图标。 | 加密 | <encrypted>c:\encryptedicon.ico</encrypted> |
用来在浏览器中标识该项目已转发的图标。 | 转发 | <forwarded>c:\forwardedicon.ico</forwarded> |
用来在功能区中标识该项目属于特定派生邮件类的图标。 | 网页 | <page>c:\pageicon.ico</page> |
用来在浏览器中标识该项目已阅读的图标。 | 读 | <read>c:\readicon.ico</read> |
用来在浏览器中标识该项目是周期性项目的图标。 | 经常性 | <recurring>c:\recurringicon.ico</recurring> |
用来在浏览器中标识该项目已答复的图标。 | 回答 | <replied>c:\repliedicon.ico</replied> |
用来在浏览器中标识该项目已进行数字签名的图标。 | 签署 | <signed>c:\signedicon.ico</signed> |
用来在浏览器中标识该项目已发送的图标。 | 提交 | <submitted>c:\submittedicon.ico</submitted> |
用来在浏览器中标识该项目尚未阅读的图标。 | 未读 | <unread>c:\unreadicon.ico</unread> |
用来在浏览器中标识该项目正在等待且尚未发送的图标。 | unsent | <unsent>c:\unsenticon.ico</unsent> |
当此项目类型已打开时要在检查器中显示的图标。 | 窗口 | <window>c:\windowicon.ico</window> |
为窗体区域指定自定义图标
在窗体区域清单 XML 文件中,在 icons 元素下指定映射到您要自定义的状态的子元素。
根据指定自定义图标文件的方式,执行以下任一操作:
- 如果希望 Outlook 从图标文件或资源文件中加载图标,请在子元素中指定图标文件或资源文件的位置。
- 如果希望外接程序通知 Outlook 要显示哪个图标,请在子元素中指定
addin
。
下面的示例为属于窗体区域所支持的邮件类的项目的多种状态指定自定义图标:
<icons>
<default>c:\icons\MyIcon.ico</default>
<unread>c:\icons\MyUnReadIcon.ico</unread>
<read>c:\icons\MyReadIcon.ico</read>
<encrypted>%windir%\myresource.dll,101</encrypted>
</icons>
四种自定义图标包括:
- 标识"已阅读"状态的自定义图标文件
- 标识"未读"状态的自定义图标文件
- 资源文件中标识"已加密"状态的位置
- 适用于项目的所有其他状态的默认图标文件
注意
子元素的值可以表示为图标文件或资源文件的文件路径,也可以表示为 addin
。 文件路径可以表示为完整路径,也可表示为窗体区域清单 XML 文件所在位置的相对路径,还可以包括系统变量。 有关使用加载项指定图标的详细信息,请参阅操作方法:使用加载项指定窗体区域的图标。
支持和反馈
有关于 Office VBA 或本文档的疑问或反馈? 请参阅 Office VBA 支持和反馈,获取有关如何接收支持和提供反馈的指南。