枚举和添加类别

项目
04/04/2023

此示例演示如何枚举类别并将一个类别添加到主类别列表。

示例

注意

下面的代码示例摘录自 Microsoft Office Outlook 2007 应用程序编程。

Outlook 对象模型支持可帮助分类用户收件箱中的项目的类别。为了保持较高的分类级别，请执行下列操作：

对 Outlook 项目进行分类并按类别显示它们。
将多个颜色类别应用到单个 Outlook 项目。
按颜色类别对 Outlook 项目进行分组和排序。
为每个颜色类别分配快捷键，使用户能够更轻松地分类项目。
通过编程方式或通过 Outlook 用户界面内的用户操作创建、删除和更改颜色类别。

为了公开类别的功能，Outlook 对象模型提供了一个 Category 对象，该对象表示主类别列表中的单个用户定义颜色类别。主类别列表包含 Outlook 用户界面中显示的颜色类别。该列表由 NameSpace 对象的 Categories 集合表示。若要创建 Category 对象，请使用 Categories 集合的 Add(String, Object, Object) 方法。当创建 Category 对象时，会创建一个全局唯一标识符 (GUID)，此标识符无法更改。此标识符通过 CategoryID 属性表示。但是，你可以通过分别设置 Category 对象的 Name、Color 和 ShortcutKey 属性，来更改与某个颜色类别关联的名称、颜色和快捷键。你可以通过设置或获取 Color 属性的 OlCategoryColor 常量来更改该属性。若要在自定义控件中重现该颜色，请使用 Category 属性的下列只读属性：

这些属性返回一个 OLE_COLOR 值，具体取决于 Category 对象的 Color 属性。

Outlook 项目是基于类别名称显示的。每个项目对象都具有一个 Categories 属性，用于存储表示类别名称的逗号分隔的字符串。（例如，对于 MailItem 对象，您将会使用 MailItemCategories 属性）。这样，您就可以将某一类别添加到项目中，即使主类别列表中不存在该类别。

注意

[!注释] 如果某个项目的 Categories 属性包含的类别名称不在 NameSpace 对象的 Categories 集合中，则将显示与该 Outlook 项目关联的类别名称，但是不会显示关联的颜色。 Item 对象的 Categories 属性不会返回 Categories 集合。

在以下代码示例中，第一个过程 EnumerateCategories 会获取当前用户的主类别列表（由 Categories 集合表示）。然后，它会枚举该集合中的 Category 对象，并将 Name 和 CategoryID 属性写入 Listeners 集合的跟踪侦听器中。第二个过程 AddACategory 会获取当前用户的主类别列表并使用 CategoryExists 方法来检查集合中是否存在名为“ISV”的类别。如果没有名为“ISV”的类别，AddACategory 将会使用 Categories 集合的 Add 方法向主类别列表添加一个名为“ISV”的类别并为其分配深蓝色的颜色。它还会为该类别分配 CTRL+F11 这一快捷键。

using Outlook = Microsoft.Office.Interop.Outlook;

private void EnumerateCategories()
{
    Outlook.Categories categories =
        Application.Session.Categories;
    foreach (Outlook.Category category in categories)
    {
        Debug.WriteLine(category.Name);
        Debug.WriteLine(category.CategoryID);
    }
}

private void AddACategory()
{
    Outlook.Categories categories =
        Application.Session.Categories;
    if (!CategoryExists("ISV"))
    {
        Outlook.Category category = categories.Add("ISV",
            Outlook.OlCategoryColor.olCategoryColorDarkBlue,
            Outlook.OlCategoryShortcutKey.olCategoryShortcutKeyCtrlF11);
    }
}

private bool CategoryExists(string categoryName)
{
    try
    {
        Outlook.Category category = 
            Application.Session.Categories[categoryName];
        if(category != null)
        {
            return true;
        }
        else
        {
            return false;
        }
    }
    catch { return false; }
}

另请参阅

颜色类别

通过

枚举和添加类别

示例

另请参阅

反馈

其他资源