分類項目を列挙および追加する

この例では、分類項目を列挙し、メイン分類項目リストに分類項目を追加する方法を示します。

例

Outlook のオブジェクト モデルは、ユーザーの受信トレイのアイテムを整理しやすくするための分類項目をサポートしています。 高レベルな整理を維持するために、以下を行うことができます。

• Outlook アイテムを分類し、分類項目ごとに表示します。
• 単一の Outlook アイテムに複数の色の分類項目を適用します。
• 色の分類項目により Outlook アイテムのグループ化と並べ替えを行います。
• 色の分類項目のそれぞれにショートカット キーを割り当てて、ユーザーがアイテムを分類しやすくします。
• プログラムにより、または Outlook のユーザー インターフェイスでのユーザー操作により、色の分類項目を作成、削除、および変更します。

Outlook オブジェクト モデルでは、分類項目の機能が利用できるように、メイン分類項目リスト内の単一のユーザー定義の色の分類項目を表す Category オブジェクトが提供されます。 メイン分類項目リストには、Outlook のユーザー インターフェイスに表示される色の分類項目が含まれます。 このリストは NameSpace オブジェクトの Categories コレクションで表されます。 Category オブジェクトを作成するには、Categories コレクションの Add(String, Object, Object) メソッドを使用します。 Category オブジェクトを作成すると、変更をすることができないグローバル一意識別子 (GUID) が作成されます。 GUID は、CategoryID プロパティに表されます。 ただし、Category オブジェクトの Name、Color、および ShortcutKey プロパティの設定をすると、色の分類項目と関連付けられた名前、色、およびショートカット キーをそれぞれ変更することができます。 Color プロパティを変更するには、そのプロパティの OlCategoryColor定数の設定または取得をします。 カスタム コントロールで色を再現するは、以下の、Category オブジェクトの読み取り専用のプロパティを使用します。

• CategoryBorderColor

• CategoryGradientBottomColor

• CategoryGradientTopColor

これらのプロパティは OLE_COLOR 値を返します。この値は Category オブジェクトの Color プロパティに依存します。

Outlook アイテムは分類項目名に基づいて表示されます。 各項目のオブジェクトには、分類項目名を表すコンマ区切り文字列を格納した Categories プロパティが含まれます。 (たとえば、 MailItem オブジェクトの場合は、 MailItemCategories プロパティを使用します)。 これにより、メインの分類項目リストにない分類項目もアイテムに追加することができます。

次のコード例で、最初のプロシージャである olCatlist では、Categories コレクションが表す現在のユーザーのメイン分類項目リストを取得します。 次に、そのコレクションの Category オブジェクトに対して順に処理を行い、 Name プロパティおよび CategoryID プロパティを Listeners コレクションのトレース リスナーに書き込みます。 2 番目のプロシージャの 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; }
}

関連項目

• 色の分類項目