MAPIFolder.SetCustomIcon(StdPicture) 方法

定义

命名空间:

Microsoft.Office.Interop.Outlook

程序集:

Microsoft.Office.Interop.Outlook.dll

为文件夹设置由 Picture 指定的自定义图标。

public:
 void SetCustomIcon(stdole::StdPicture ^ Picture);

public void SetCustomIcon (stdole.StdPicture Picture);

Public Sub SetCustomIcon (Picture As StdPicture)

参数

Picture

StdPicture

为文件夹指定自定义图标。

注解

StdPicture指定的 Picture 对象必须具有等于 PICTYPE_ICON 或 PICTYPE_BITMAP 的 Type 属性。 图标或位图资源可以具有的最大大小为 32 x 32。 图标 16x16 或 24x24 也支持，和Microsoft Outlook可以扩大 16 x 16 图标，如果在高点每英寸 (DPI) 模式下运行 Outlook。 其他大小的图标会导致 SetCustomIcon 返回一个错误。

搜索文件夹和特殊文件夹或所有文件夹，不表示默认情况下，您可以设置自定义图标。 如果您尝试为属于下列组的文件夹的某个文件夹设置自定义图标，则 SetCustomIcon 将返回一个错误:

您只能从代码，运行在进程内为 Outlook 调用 GetCustomIcon 。 StdPicture对象不能跨进程边界封送。 如果您尝试从进程外的代码中调用 GetCustomIcon 时，会发生异常。 有关详细信息，请参阅 自动化服务器无法跨进程边界传递指向图片对象的 IPictureDisp 实现的指针

此方法提供的自定义文件夹图标不会在运行中 Outlook 会话外持久保留。 因此，加载项必须在每次 Outlook 启动时设置自定义文件夹图标。

自定义文件夹图标不会出现在其他 Exchange 客户端中（如 Outlook Web Access），也不会出现在 Windows Mobile 设备上运行的 Outlook 中。