Outlook 窗体区域创建准则

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

  • 使用窗体区域名称。

  • 禁用窗体区域继承。

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

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

  • 使用最佳图标大小。

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

**适用于:**本主题中的信息适用于 Outlook 2007 和 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 窗体区域