チュートリアル : Outlook でデザインしたフォーム領域のインポート

[アーティクル]
02/21/2013

このチュートリアルでは、Microsoft Office Outlook でフォーム領域をデザインする方法と、新しいフォーム領域ウィザードを使用して Outlook アドインプロジェクトにフォーム領域をインポートする方法について説明します。Outlook でフォーム領域をデザインすると、Outlook データにバインドされたネイティブ Outlook コントロールをフォーム領域に追加できます。フォーム領域をインポートした後で、各コントロールのイベントを処理できます。

対象: このトピックの情報は、Outlook 2013 と Outlook 2010 のアプリケーションレベルのプロジェクトに適用されます。詳細については、「Office アプリケーションおよびプロジェクトタイプ別の使用可能な機能」を参照してください。

このチュートリアルでは、次の作業について説明します。

Outlook でのフォーム領域デザイナーを使用したフォーム領域のデザイン
フォーム領域の Outlook アドインプロジェクトへのインポート
フォーム領域上のコントロールのイベント処理

[!メモ]

お使いのマシンで、Visual Studio ユーザーインターフェイスの一部の要素の名前や場所が、次の手順とは異なる場合があります。これらの要素は、使用している Visual Studio のエディションや独自の設定によって決まります。詳細については、「Visual Studio の設定」を参照してください。

必須コンポーネント

このチュートリアルを実行するには、次のコンポーネントが必要です。

Microsoft Office Developer Tools が含まれているエディションの Visual Studio 2012。詳細については、「[Office ソリューションを開発できるようにコンピューターを構成する](bb398242\(v=vs.110\).md)」を参照してください。

Outlook 2013 または Outlook 2010。

[!メモ]

次の手順で参照している Visual Studio ユーザーインターフェイス要素の一部は、お使いのコンピューターでは名前や場所が異なる場合があります。これらの要素は、使用する Visual Studio のエディションとその設定によって決まります。詳細については、「Visual Studio の設定」を参照してください。

ビデオへのリンク関連のビデオデモについては、「How Do I: Create Outlook Form Regions Using Visual Studio 2008? (操作方法: Visual Studio 2008 を使用して Outlook フォーム領域を作成する)」を参照してください。

Outlook でのフォーム領域デザイナーを使用したフォーム領域のデザイン

この手順では、Outlook でフォーム領域をデザインします。次に、そのフォーム領域を Visual Studio にインポートできるように見つけやすい場所に保存します。

ここで作成するフォーム領域は、通常の仕事フォームと完全に置き換わります。このフォーム領域では、主要な仕事の実行前に完了していることが必要な仕事 (前提となる仕事) の進行状況を追跡できます。このフォーム領域には前提となる仕事の一覧が表示され、各仕事の完了ステータスが示されます。ユーザーは、この一覧に対して仕事を追加および削除できます。ユーザーは各仕事の完了ステータスを更新することもできます。

Outlook でフォーム領域デザイナーを使用してフォーム領域をデザインするには

Microsoft Office Outlook を起動します。
Outlookで、[Developer] のタブで、**[フォームのデザイン]**をクリックします。詳細については、「方法 : [開発] タブをリボンに表示する」を参照してください。
[フォームのデザイン] ダイアログボックスで、[仕事] をクリックし、[開く] をクリックします。
Outlookで、[Developer] のタブで、[デザイン] のグループで、をクリック [新しいフォーム領域]。

新しいフォーム領域が開きます。[フィールドの選択] が表示されない場合は、[ツール] グループ内の [フィールドの選択] をクリックします。
[フィールドの選択] から [件名] フィールドと [達成率] フィールドをフォーム領域にドラッグします。
[ツール] グループで、[コントロールツールボックス] をクリックして、[ツールボックス] を開きます。
[ツールボックス] から Label コントロールをフォーム領域にドラッグします。ラベルを [件名] フィールドと [達成率] フィールドの下に配置します。
ラベルを右クリックし、[プロパティの詳細] をクリックします。
[プロパティ] ウィンドウで、[キャプション] プロパティを「This task depends on the following tasks」に設定し、[幅] プロパティを 200 に設定します。次に、[適用] をクリックします。
**[ツールボックス]**から ListBox コントロールをフォーム領域にドラッグします。リストボックスを This task depends on the following tasks ラベルの下に配置します。
追加したリストボックスを選択します。
[プロパティ] ウィンドウで、[幅] を 300 に設定し、[適用] をクリックします。
[ツールボックス] から Label コントロールをフォーム領域にドラッグします。ラベルをリストボックスの下に配置します。
追加したラベルを選択します。
[プロパティ] ウィンドウで、[キャプション] プロパティを「Select a task to add to the list of dependent tasks」に設定し、[幅] プロパティを 200 に設定します。次に、[適用] をクリックします。
[ツールボックス] から ComboBox コントロールをフォーム領域にドラッグします。コンボボックスを Select a task to add to the list of dependent tasks ラベルの下に配置します。
追加したコンボボックスを選択します。
[プロパティ] ウィンドウで、[幅] プロパティを 300 に設定し、[適用] をクリックします。
[ツールボックス] から CommandButton コントロールをフォーム領域にドラッグします。コマンドボタンをコンボボックスの隣に配置します。
追加したコマンドボタンを選択します。
[プロパティ] ウィンドウで、[名前] を「AddDependentTask」に設定し、[キャプション] を「Add Dependent Task」に設定し、[幅] を 100 に設定します。次に、[適用] をクリックします。
[フィールドの選択] の [新規フィールド] をクリックします。
[新規フィールドの作成] ダイアログボックスの [名前] フィールドに「hiddenField」と入力し、[OK] をクリックします。
[フィールドの選択] から [hiddenField] フィールドをフォーム領域にドラッグします。
[プロパティ] ウィンドウで、[可視] を 0 (False) に設定し、[適用] をクリックします。
Outlookで、[Developer] のタブで、[デザイン] のグループで、をクリックし、を [フォーム領域に名前を付けて保存][保存] のボタンをクリックします。

フォーム領域に TaskFormRegion という名前を付け、コンピューターのローカルディレクトリに保存します。

このフォーム領域は Outlook Form Storage (.ofs) ファイルとして保存されます。ファイル名は TaskFormRegion.ofs となります。
Outlook を終了します。

新しい Outlook アドインプロジェクトの作成

この手順では、Outlook アドインプロジェクトを作成します。後の手順で、このプロジェクトにフォーム領域をインポートします。

新しい Outlook アドインプロジェクトを作成するには

Visual Studio で、TaskAddIn という名前の Outlook アドインプロジェクトを作成します。
[新しいプロジェクト] ダイアログボックスの [ソリューションのディレクトリを作成] チェックボックスをオンにします。
プロジェクトを既定のプロジェクトディレクトリに保存します。

詳細については、「方法: Visual Studio で Office プロジェクトを作成する」を参照してください。

フォーム領域のインポート

新しい Outlook フォーム領域ウィザードを使用して、Outlook でデザインしたフォーム領域を Outlook アドインプロジェクトにインポートできます。

フォーム領域を Outlook アドインプロジェクトにインポートするには

ソリューションエクスプローラーで、[TaskAddIn] プロジェクトを右クリックし、[追加] をポイントして、[新しい項目] をクリックします。
[テンプレート] ペインで [Outlook フォーム領域] を選択し、ファイルに TaskFormRegion という名前を付けて、[追加] をクリックします。

新しいOutlook フォーム領域ウィザードが起動します。
[フォーム領域を作成する方法の選択] ページで [Outlook Form Storage (.ofs) ファイルのインポート] をクリックし、[参照] をクリックします。
[既存の Outlook フォーム領域ファイルの場所] ダイアログボックスで、TaskFormRegion.ofs があるフォルダーまで移動して TaskFormRegion.ofs を選択し、[開く] をクリックして、[次へ] をクリックします。
[作成するフォーム領域の種類を選択します] ページで [すべて置換] をクリックし、[次へ] をクリックします。

Outlook フォーム全体がすべて置換フォーム領域に置き換わります。フォーム領域の種類の詳細については、「Outlook フォーム領域の作成」を参照してください。
[説明用のテキストを指定し、表示設定を選択します] ページで [次へ] をクリックします。
[このフォーム領域を表示するメッセージクラスを識別します] ページの [このフォーム領域を表示するカスタムメッセージクラスを選択] フィールドに「IPM.Task.TaskFormRegion」と入力し、[完了] をクリックします。

TaskFormRegion.cs ファイルまたは TaskFormRegion.vb ファイルがプロジェクトに追加されます。

フォーム領域上のコントロールのイベント処理

プロジェクトにフォーム領域を追加したので、次に Outlook のフォーム領域に追加したボタンの Microsoft.Office.Interop.Outlook.OlkCommandButton.Click イベントを処理するコードを追加できます。

また、フォーム領域が表示されたときにフォーム領域上のコントロールを更新する FormRegionShowing イベントにコードを追加します。

フォーム領域上のコントロールのイベントを処理するには

ソリューションエクスプローラーで TaskFormRegion.cs または TaskFormRegion.vb を右クリックし、[コードの表示] をクリックします。

TaskFormRegion.cs ファイルまたは TaskFormRegion.vb ファイルがコードエディターで開きます。

TaskFormRegion クラスに次のコードを追加します。このコードは、Outlook の仕事フォルダーから各仕事の件名を取得し、フォーム領域上のコンボボックスに表示します。

Private Sub populateComboBox()
    Dim Application As New Outlook.Application()
    Dim outlookNameSpace As Outlook.NameSpace = _
    Application.GetNamespace("MAPI")
    Dim taskFolder As Outlook.MAPIFolder = _
    outlookNameSpace.GetDefaultFolder _
        (Microsoft.Office.Interop.Outlook.OlDefaultFolders.olFolderTasks)
    Dim taskItems As Outlook.Items = taskFolder.Items
    Dim task As Outlook.TaskItem
    For Each task In taskItems
        If Not (task.Subject Is Nothing) Then
            comboBox1.AddItem(task.Subject, System.Type.Missing)
        End If
    Next task
    comboBox1.Text = comboBox1.GetItem(0)
End Sub

private void populateComboBox()
{
    Outlook.Application Application = new Outlook.Application();
    Outlook.NameSpace outlookNameSpace = Application.GetNamespace("MAPI");
    Outlook.MAPIFolder taskFolder = outlookNameSpace.GetDefaultFolder(
        Microsoft.Office.Interop.Outlook.OlDefaultFolders.olFolderTasks);
    Outlook.Items taskItems = taskFolder.Items;
    foreach (Outlook.TaskItem task in taskItems)
    {
        if (task.Subject != null)
        {
            comboBox1.AddItem(task.Subject, System.Type.Missing);
        }
    }
    comboBox1.Text = comboBox1.GetItem(0);
}

TaskFormRegion クラスに次のコードを追加します。このコードは次のタスクを実行します。

FindTaskBySubjectName ヘルパーメソッドを呼び出して目的の仕事の件名を渡すことにより、仕事フォルダー内で Microsoft.Office.Interop.Outlook.TaskItem を検索します。FindTaskBySubjectName ヘルパーメソッドは次の手順で追加します。
依存関係にある仕事のリストボックスに Microsoft.Office.Interop.Outlook.TaskItem.Subject 値と Microsoft.Office.Interop.Outlook.TaskItem.PercentComplete 値を追加します。
フォーム領域の隠しフィールドに仕事の件名を追加します。追加した値が Outlook のアイテムの一部として隠しフィールドに格納されます。

Private Sub AddDependentTask_Click1() Handles addDependentTask.Click
    Dim tempTaskItem As Outlook.TaskItem = FindTaskBySubjectName _
        (comboBox1.Text)
    If Not (tempTaskItem Is Nothing) Then
        Me.listBox1.AddItem(tempTaskItem.PercentComplete.ToString() & _
            "% Complete -- " & tempTaskItem.Subject, System.Type.Missing)
        Me.olkTextBox3.Text = Me.olkTextBox3.Text & "|" & tempTaskItem.Subject
    End If
End Sub

    void AddDependentTask_Click()
    {
        Outlook.TaskItem tempTaskItem = FindTaskBySubjectName(comboBox1.Text);
        if (tempTaskItem != null)
        {
            this.listBox1.AddItem(tempTaskItem.PercentComplete.ToString()
+ "% Complete -- " + tempTaskItem.Subject, System.Type.Missing);
            this.olkTextBox3.Text = this.olkTextBox3.Text + "|" + 
                tempTaskItem.Subject;
        }
    }

TaskFormRegion クラスに次のコードを追加します。このコードは、前の手順で説明した FindTaskBySubjectName ヘルパーメソッドを提供します。

Private Function FindTaskBySubjectName(ByVal subjectName As String) _
    As Outlook.TaskItem
    Dim Application As New Outlook.Application()
    Dim outlookNameSpace As Outlook.NameSpace = _
        Application.GetNamespace("MAPI")
    Dim tasksFolder As Outlook.MAPIFolder = _
        outlookNameSpace.GetDefaultFolder _
            (Microsoft.Office.Interop.Outlook.OlDefaultFolders.olFolderTasks)
    Dim taskItems As Outlook.Items = tasksFolder.Items
    Dim taskItem As Outlook.TaskItem
    For Each taskItem In taskItems
        If taskItem.Subject = subjectName Then
            Return taskItem
        End If
    Next taskItem
    Return Nothing
End Function

private Outlook.TaskItem FindTaskBySubjectName(string subjectName)
{
    Outlook.Application Application = new Outlook.Application();
    Outlook.NameSpace outlookNameSpace = Application.GetNamespace("MAPI");
    Outlook.MAPIFolder tasksFolder =
        outlookNameSpace.GetDefaultFolder(
    Microsoft.Office.Interop.Outlook.
        OlDefaultFolders.olFolderTasks);
    Outlook.Items taskItems = tasksFolder.Items;
    foreach (Outlook.TaskItem taskItem in taskItems)
    {
        if (taskItem.Subject == subjectName)
        {
            return taskItem;
        }
    }
    return null;
}

TaskFormRegion クラスに次のコードを追加します。このコードは次のタスクを実行します。

フォーム領域のリストボックスを依存関係にある各仕事の現在の完了ステータスで更新します。
隠しテキストフィールドを解析し、依存関係にある各仕事の件名を取得します。さらに、FindTaskBySubjectName ヘルパーメソッドを呼び出して各仕事の件名を渡すことにより、仕事フォルダー内で各 Microsoft.Office.Interop.Outlook.TaskItem を検索します。
依存関係にある仕事のリストボックスに Microsoft.Office.Interop.Outlook.TaskItem.Subject 値と Microsoft.Office.Interop.Outlook.TaskItem.PercentComplete 値を追加します。

Private Sub RefreshTaskListBox()
    listBox1.Clear()
    Dim tempTaskItem As Outlook.TaskItem
    Dim tempArray As [String]() = olkTextBox3.Text.Split(New [Char]() {"|"c})

    Dim tempString As String
    For Each tempString In tempArray
        tempTaskItem = FindTaskBySubjectName(tempString)
        If Not (tempTaskItem Is Nothing) Then
            Me.listBox1.AddItem(tempTaskItem.PercentComplete.ToString() & _
                "% Complete -- " & tempTaskItem.Subject, System.Type.Missing)
        End If
    Next tempString
End Sub

void RefreshTaskListBox()
{
    listBox1.Clear();
    Outlook.TaskItem tempTaskItem;
    String[] tempArray = olkTextBox3.Text.Split(new Char[] { '|' });

    foreach (string tempString in tempArray)
    {
        tempTaskItem = FindTaskBySubjectName(tempString);
        if (tempTaskItem != null)
        {
            this.listBox1.AddItem(tempTaskItem.PercentComplete.ToString()
                + "% Complete -- " + tempTaskItem.Subject, 
                    System.Type.Missing);
        }
    }
}

TaskFormRegion_FormRegionShowing イベントハンドラーを次のコードで置き換えます。このコードは次のタスクを実行します。
- フォーム領域が表示されたときに、フォーム領域のコンボボックスに仕事の件名を表示します。
- フォーム領域が表示されたときに、RefreshTaskListBox ヘルパーメソッドを呼び出します。これにより、アイテムを開いたときにリストボックスに追加された依存関係にある仕事が表示されます。
```
Private Sub TaskFormRegion_FormRegionShowing(ByVal sender As Object, _
    ByVal e As System.EventArgs) Handles MyBase.FormRegionShowing
    populateComboBox()
    RefreshTaskListBox()
End Sub
```
```
private void TaskFormRegion_FormRegionShowing
    (object sender, EventArgs e)
{
    populateComboBox();
    RefreshTaskListBox();
    this.addDependentTask.Click += new
    Microsoft.Office.Interop.Outlook.
        OlkCommandButtonEvents_ClickEventHandler(AddDependentTask_Click);

}
```

Outlook フォーム領域のテスト

フォーム領域をテストするには、フォーム領域の前提となる仕事の一覧に仕事を追加します。前提となる仕事の完了ステータスを更新し、その仕事の更新された完了ステータスを前提となる仕事の一覧に表示します。

フォーム領域をテストするには

F5 キーを押してプロジェクトを実行します。

Outlook が起動します。
Outlookで、[ホーム] のタブで、をクリック **[新しい品目]**は、を **[タスク]**をクリックします。
タスクフォームの [件名] フィールドに「Dependent Task」と入力します。
リボンの [仕事] タブで、[アクション] グループの [保存して閉じる] をクリックします。
Outlookで、[ホーム] のタブで、をクリック **[新しい品目]は、[その他のアイテム]をクリックし、[フォームの選択]**をクリックします。
[フォームの選択] ダイアログボックスで [TaskFormRegion] をクリックし、[開く] をクリックします。

TaskFormRegion フォーム領域が表示されます。このフォーム領域が仕事フォーム全体と置き換わります。[Select a task to add to the list of dependent tasks] コンボボックスに仕事フォルダー内の他の仕事が表示されます。
仕事フォームの [件名] フィールドに「Primary Task」と入力します。
[Select a task to add to the list of dependent tasks] コンボボックスで [Dependent Task] をクリックし、[Add Dependent Task] をクリックします。

[This task depends on the following tasks] リストボックスに [達成率 0% -- Dependent Task] と表示されます。これで、ボタンの Microsoft.Office.Interop.Outlook.OlkCommandButton.Click イベントが正常に処理されたことがわかります。
Primary Task アイテムを保存して閉じます。
Dependent Task アイテムを Outlook で再度開きます。
Dependent Task フォームで、[達成率] フィールドの値を 50% に変更します。
Dependent Task リボンの [仕事] タブで、[アクション] の [保存して閉じる] をクリックします。
Outlook で Primary Task アイテムを再度開きます。

今度は、[This task depends on the following tasks] リストボックスに [達成率 50% -- Dependent Task] と表示されます。

次の手順

Outlook の UI をカスタマイズする方法の詳細については、次のトピックを参照してください。

マネージコントロールをビジュアルデザイナーにドラッグしてフォーム領域の外観をデザインする方法の詳細については、「チュートリアル : Outlook フォーム領域のデザイン」を参照してください。
Outlook アイテムのリボンをカスタマイズする方法の詳細については、「Outlook のリボンのカスタマイズ」を参照してください。
Outlook にカスタム作業ウィンドウを追加する方法の詳細については、「カスタム作業ウィンドウ」を参照してください。

参照

次の方法で共有

チュートリアル : Outlook でデザインしたフォーム領域のインポート

必須コンポーネント

Outlook でのフォーム領域デザイナーを使用したフォーム領域のデザイン

Outlook でフォーム領域デザイナーを使用してフォーム領域をデザインするには

新しい Outlook アドインプロジェクトの作成

新しい Outlook アドインプロジェクトを作成するには

フォーム領域のインポート

フォーム領域を Outlook アドインプロジェクトにインポートするには

フォーム領域上のコントロールのイベント処理

フォーム領域上のコントロールのイベントを処理するには

Outlook フォーム領域のテスト

フォーム領域をテストするには

次の手順

参照

処理手順

概念

その他の技術情報

その他のリソース

次の方法で共有

チュートリアル : Outlook でデザインしたフォーム領域のインポート

必須コンポーネント

Outlook でのフォーム領域デザイナーを使用したフォーム領域のデザイン

Outlook でフォーム領域デザイナーを使用してフォーム領域をデザインするには

新しい Outlook アドイン プロジェクトの作成

新しい Outlook アドイン プロジェクトを作成するには

フォーム領域のインポート

フォーム領域を Outlook アドイン プロジェクトにインポートするには

フォーム領域上のコントロールのイベント処理

フォーム領域上のコントロールのイベントを処理するには

Outlook フォーム領域のテスト

フォーム領域をテストするには

次の手順

参照

処理手順

概念

その他の技術情報

その他のリソース

新しい Outlook アドインプロジェクトの作成

新しい Outlook アドインプロジェクトを作成するには

フォーム領域を Outlook アドインプロジェクトにインポートするには