[WALKTHROUGH] InfoPath 2003 オブジェクトモデルを使用して基本的なフォームテンプレートを作成およびデバッグする方法

2010-04-27

ここでは、Microsoft.Office.Interop.InfoPath.SemiTrust 名前空間から提供される InfoPath 2003 互換オブジェクトモデルを使用する基本的な InfoPath マネージコードフォームテンプレートを作成する手順を順をおって説明します。

Hello World

次の例では、InfoPath 2003 互換オブジェクトモデルの Alert メソッドを使用して簡単な警告ダイアログボックスを表示する方法を説明します。

InfoPath 2003 互換オブジェクトモデルを使用する新しい InfoPath フォームテンプレートを作成する

「[方法] InfoPath 2003 オブジェクトモデルを使用してマネージコードフォームテンプレートを作成する方法」の説明に従って、InfoPath 2003 互換オブジェクトモデルを使用する新しいフォームテンプレートを作成します。
フォームテンプレートプロジェクトを HelloWorld という名前で保存します。

プロジェクトシステムがコードファイルとプロジェクトファイルを作成し、InfoPath のデザインモードで空白のフォームテンプレートを開きます。これでイベントハンドラを追加する準備ができました。

OnClick イベントハンドラを追加する

[デザインタスク] 作業ウィンドウの [コントロール] をクリックします。
InfoPath (Microsoft Visual Studio Tools for Applications (VSTA) インストール済み) で作業している場合は、[基本コントロール] の [ボタン] コントロールをクリックして、ビューに挿入します。

Visual Studio 2005 と Microsoft Visual Studio 2005 Tools for the 2007 Microsoft Office System または Visual Studio 2008 と Visual Studio Tools for Office で作業している場合は、[ツールボックス] から [manifest.xsf [デザイン]] フォームデザイナに [ボタン] コントロールをドラッグします。
ボタンをダブルクリックして、[ボタンのプロパティ] ダイアログボックスを開きます。
[ラベル] を Alert に変更します。
[ID] を AlertID に変更します。
[フォームのコードを編集] をクリックします。

OnClick イベントのイベントハンドラスケルトンが作成され、VSTA または Visual Studio のコードエディタにフォーカスが移動します。イベントハンドラの使用の詳細については、「[方法] InfoPath 2003 オブジェクトモデルを使用してイベントハンドラを追加する方法」を参照してください。

これでボタンのイベントハンドラにフォームコードを追加する準備ができました。

イベントハンドラにフォームコードを追加する

OnClick イベントハンドラに次のコードを入力します。

thisXDocument.UI.Alert("Hello World!");

thisXDocument.UI.Alert("Hello World!")

コード行に含まれるピリオドを入力するたびに Microsoft IntelliSense のボックスが表示されます。イベントハンドラ全体は次のようになります。

[InfoPathEventHandler(MatchPath="AlertID", EventType=InfoPathEventType.OnClick)]
public void AlertID_OnClick(DocActionEvent e)
{
    thisXDocument.UI.Alert("Hello World!");
}

<InfoPathEventHandler(MatchPath:="AlertID", EventType:=InfoPathEventType.OnClick)>
Public Sub AlertID_OnClick(ByVal e As DocActionEvent)
    thisXDocument.UI.Alert("Hello World!")
End Sub

メモ :
Alert メソッドを使用する代わりに、System.Windows.Forms 名前空間の MessageBox.Show メソッドを使用してメッセージボックスを表示することもできます。それには、System.Windows.Forms アセンブリへの参照を追加し、コードファイル先頭のディレクティブに `using System.Windows.Forms;` または `Imports System.Windows.Forms` を追加し、`MessageBox.Show("Hello World!); or MessageBox.Show("Hello World!)` のようなコード行を入力する必要があります。

メモ :

Alert メソッドを使用する代わりに、System.Windows.Forms 名前空間の MessageBox.Show メソッドを使用してメッセージボックスを表示することもできます。それには、System.Windows.Forms アセンブリへの参照を追加し、コードファイル先頭のディレクティブに using System.Windows.Forms; または Imports System.Windows.Forms を追加し、MessageBox.Show("Hello World!); or MessageBox.Show("Hello World!) のようなコード行を入力する必要があります。

InfoPath (VSTA) を使用している場合は、InfoPath のデザインモードウィンドウに切り替え、[標準] ツールバーの [プレビュー] をクリックします。

Visual Studio で作業している場合は、[デバッグ] メニューの [デバッグ開始] をクリックします (または F5 キーを押します)。
[プレビュー] ウィンドウで [Alert] をクリックします。

"Hello World!" という内容のメッセージボックスが表示されます。

次の手順は、フォームコードにデバッグ用のブレークポイントを追加する方法を示しています。

フォームコードをデバッグする

コードエディタで次の行の左にあるグレーのバーをクリックします。
```
thisXDocument.UI.Alert("Hello World!");
```
```
thisXDocument.UI.Alert("Hello World!")
```
赤い円が表示され、コード行が強調表示されます。これは、ランタイムがフォームコードのこのブレークポイントで一時停止することを表しています。
[デバッグ] メニューの [デバッグ開始] をクリックします (または F5 キーを押します)。
InfoPath の [プレビュー] ウィンドウで [Alert] をクリックします。

コードエディタにフォーカスが移動し、ブレークポイント行が強調表示されます。
[デバッグ] メニューの [ステップオーバー] をクリック (または F10 キーを押下) して、コードのステップスルーを続行します。

Alert メソッドのコードが実行され、InfoPath の [プレビュー] ウィンドウに "Hello World!" という通知が表示されます。

現在のユーザーの名前を取得する

.NET Framework のクラスを使用すると、スクリプトでは簡単に利用できなかった機能を利用できます。この例では、.NET Framework のクラスを使用して現在のユーザーの名前を取得する方法を説明します。

OnLoad イベントハンドラを追加する

前の例で作成した InfoPath HelloWorld プロジェクトを開きます。
[表示] メニューの [データソース] をクリックします。
[マイフィールド] ノードを右クリックし、[追加] をクリックします。
[名前] ボックスに「employee」と入力し、[OK] をクリックします。
[employee] ノードをビューにドラッグします。
InfoPath (VSTA) で作業している場合は、[ツール] メニューの [プログラミング] をクリックし、[Loading イベント] をクリックします。

Visual Studio で作業している場合は、[挿入] メニューの [イベント] をクリックし、[Loading イベント] をクリックします。

これによって OnLoad イベントのイベントハンドラが作成され、コードエディタにフォーカスが移動します。フォームを読み込むたびに、このイベントハンドラのコードが呼び出されます。次の手順は、ユーザーの名前を取得するフォームコードをイベントハンドラに追加する方法を示しています。

フォームコードを追加する

OnLoad イベントハンドラに次のコードを入力します。

// Store an XML DOM node as a local variable.
IXMLDOMNode nodeEmployee = thisXDocument.DOM.selectSingleNode("my:myFields/my:employee");
if(nodeEmployee != null)
{
    if(nodeEmployee.text == "")
    {
    // If the employee name is blank when the form is loaded, 
    // populate the employee node with the current user name.
    nodeEmployee.text = System.Environment.UserName;
    }
}

// Store an XML DOM node as a local variable.
Dim nodeEmployee As IXMLDOMNode
nodeEmployee = thisXDocument.DOM.selectSingleNode("my:myFields/my:employee");
If Not(nodeEmployee Is Nothing) Then
    If(nodeEmployee.text = "") Then
    // If the employee name is blank when the form is loaded, 
    // populate the employee node with the current user name.
    nodeEmployee.text = System.Environment.UserName
    End If
End If

フォームをコンパイルおよびプレビューします。

[employee] ボックスに自分のユーザー名が表示されます。

マネージコードフォームテンプレートの展開方法については、「[方法] InfoPath プロジェクトを展開する方法」を参照してください。InfoPath オブジェクトモデルと、InfoPath 2003 互換オブジェクトモデルを使用するマネージコードフォームテンプレートでよく行うプログラミング作業については、「InfoPath 2003 オブジェクトモデルを理解する」を参照してください。

次の方法で共有

[WALKTHROUGH] InfoPath 2003 オブジェクト モデルを使用して基本的なフォーム テンプレートを作成およびデバッグする方法

Hello World

InfoPath 2003 互換オブジェクト モデルを使用する新しい InfoPath フォーム テンプレートを作成する

OnClick イベント ハンドラを追加する

イベント ハンドラにフォーム コードを追加する

フォーム コードをデバッグする

現在のユーザーの名前を取得する

OnLoad イベント ハンドラを追加する

フォーム コードを追加する

関連項目

タスク

概念

その他のリソース