Outlook 窗体区域创建准则

以下信息有助于优化窗体区域和避免潜在问题:

  • 使用窗体区域名称。

  • 禁用窗体区域继承。

  • 了解类型名称和邮件类名称。

  • 为“阅读窗格”设计相邻窗体区域。

  • 使用最佳图标大小。

有关窗体区域的更多信息,请参见创建 Outlook 窗体区域

**适用于:**本主题中的信息适用于 Outlook 2013 和 Outlook 2010 的应用程序级项目。有关更多信息,请参见按 Office 应用程序和项目类型提供的功能

使用窗体区域名称

有一些用于描述窗体区域的名称。了解这些名称之间的区别,以及它们如何影响窗体区域是很重要的。下表介绍每个名称。

窗体区域名称

描述

窗体区域项名称

“添加新项”对话框中为“Outlook 窗体区域”项指定的名称。该名称是显示在“解决方案资源管理器”中的窗体区域代码文件的名称。

FormRegionName 属性

“新建 Outlook 窗体区域”向导的“提供说明性文本并选择显示首选项”页面中指定该名称。该名称在“属性”窗口中显示为“FormRegionName”属性。

使用 FormRegionName 属性可以指定在 Outlook 用户界面 (UI) 中标识窗体区域的标签。对于单独的窗体区域,该名称在 Outlook 项的功能区中显示为按钮。

对于相邻窗体区域,该名称作为页眉文本显示在窗体区域上方。

Microsoft.Office.Tools.Outlook.FormRegionName 特性

在将“Outlook 窗体区域”项添加到项目时,Visual Studio 将此属性设置为窗体区域的完全限定名。默认的完全限定名由外接程序名称加上窗体区域名称构成,两者之间以点分隔,例如OutlookAddIn1.FormRegion1。

该完全限定名还作为特性显示在窗体区域工厂类的顶部。

使用 Microsoft.Office.Tools.Outlook.FormRegionName 特性可以在所有 Outlook 外接程序中唯一标识窗体区域。不能通过重命名窗体区域项或通过更改 FormRegionName 属性来更改 Microsoft.Office.Tools.Outlook.FormRegionName 特性的值。若要更改此名称,必须在窗体区域代码文件中修改 Microsoft.Office.Tools.Outlook.FormRegionName 特性。

禁用窗体区域继承

默认情况下,自定义邮件类继承与基础邮件类关联的所有窗体区域。例如,名为 IPM.Task.Contoso 的邮件类派生自 IPM.Task。因此,IPM.Task.Contoso 继承 IPM.Task 的窗体区域关联。

如果不希望窗体区域与任何派生的邮件类关联,请将窗体区域的 ExactMessageClass 属性设置为 true。例如,如果将一个相邻窗体区域与 IPM.Task 关联,并将 ExactMessageClass 属性设置为 true,该窗体区域将只是追加到标准任务窗体的底部。该窗体区域将不会追加到标准任务窗体的任何自定义版本的底部。

了解类型名称和邮件类名称

Outlook 项的类型名称与 Outlook 项的邮件类名称不同。例如,RSS 项的类型名称为 Microsoft.Office.Interop.Outlook.PostItem。而 RSS 项的邮件类名称为 IPM.Post.RSS

使用类型名称可以在代码中引用 Outlook 项。有关类型名称的列表,请参见将窗体区域与 Outlook 邮件类关联

使用**“新建 Outlook 窗体区域”**向导中的 Outlook 项的邮件类名称,可以将项与窗体区域相关联。有关有效的邮件类名称的列表,请参见将窗体区域与 Outlook 邮件类关联

为“阅读窗格”设计相邻窗体区域

使用 Outlook“阅读窗格”,可以在不打开 Outlook 项的情况下预览该项。“阅读窗格”仅为阅读而设计。因此,对于添加到相邻窗体区域中的输入控件(如文本框),在“阅读窗格”中打开该项和窗体区域时,其行为可能与预期不同。

例如,在“阅读窗格”中打开具有相邻窗体区域的项时,可能会出现下面的情况:

  1. 在窗体区域上的文本框中选择一些文本。

  2. 按 Delete。

  3. 删除整个邮件项,而不只删除文本框中的文本。

如果要设计包含输入控件的相邻窗体区域,请在“阅读窗格”中测试该控件,以确保它们正常工作。考虑添加自定义代码,用来禁用不能按预期方式工作的控件。

此外,也可以将窗体区域的 ShowInspectorRead 属性设置为 False。这样就无法在“阅读窗格”中使用窗体区域。

使用最佳图标大小

通过在**“属性”窗口的“图标”**属性组中设置图标属性,可以指定希望窗体区域显示的图标。为获得最佳显示质量,请遵循以下准则:

  • 对于**“页面”**图标,请使用可移植网络图形 (PNG) 文件。

  • **“窗口”**图标应为 32 x 32 像素。

  • 所有其他图标应为 16 x 16 像素。

对于具有单独的、替换或全部替换窗体区域的项,**“页面”**图标显示在检查器的功能区中。

**“窗口”**图标显示在通知区域中,对于显示替换或全部替换窗体区域的打开项,该图标显示在“Alt+Tab”对话框中。

请参见

任务

演练:设计 Outlook 窗体区域

如何:向 Outlook 外接程序项目中添加窗体区域

概念

在运行时访问窗体区域

将窗体区域与 Outlook 邮件类关联

其他资源

创建 Outlook 窗体区域