チュートリアル: InfoPath オブジェクトモデルを使用して基本的なフォームテンプレートを作成およびデバッグする

このトピックでは、 Microsoft.Office.Interop.InfoPath.SemiTrust 名前空間によって提供される InfoPath 2003 互換オブジェクトモデルで動作する基本的な InfoPath マネージコードフォームテンプレートを作成するチュートリアルについて説明します。

Hello World

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

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

InfoPath 2003 オブジェクトモデルを使用したフォームテンプレートの作成に関するページの説明に従って、 InfoPath 2003 互換オブジェクトモデルで動作する新しいフォームテンプレートを作成します。
フォームテンプレートプロジェクトを HelloWorld という名前で保存します。

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

OnClick イベントハンドラーを設定したボタンを追加する

[ホーム] タブの [コントロール] セクションで、[ボタン] コントロールをクリックして、ビューに挿入します。
挿入したコントロールを右クリックして、[ボタンのプロパティ] をクリックします。
[ラベル] を [アラート] に変更します。
ID を AlertID に変更します。
[フォームのコードを編集] をクリックします。

OnClick イベントのイベントハンドラースケルトンが作成され、フォーカスが Visual Studio 2012 のコードエディターに移動します。イベントハンドラーの操作の詳細については、「 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 アセンブリへの参照を追加し、コードファイルの先頭にあるディレクティブにまたは Imports System.Windows.Forms を追加using System.Windows.Forms;し、次のようなコード行を入力する必要があります。MessageBox.Show("Hello World!); or MessageBox.Show("Hello World!)
InfoPath のデザインモードウィンドウに切り替え、[ホーム] タブの [プレビュー] ボタンをクリックします。
[プレビュー] ウィンドウで [Alert] をクリックします。

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

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

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

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

コードエディターにフォーカスが移動し、ブレークポイント行が強調表示されます。
[デバッグ] メニューで [ステップオーバー] をクリックするか、または Shift キーを押しながら F8 キーを押して、コード内を順に移動します。

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

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

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

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

前の例で作成した InfoPath HelloWorld プロジェクトを開きます。
[表示] タブの [フィールドの表示] をクリックします。
[マイフィールド] ノードを右クリックし、[追加] をクリックします。
[ 名前] に「 employee」と入力し、[OK] をクリック します。
[employee] ノードをビューにドラッグします。
[開発] タブの [OnLoad イベント] をクリックします。

これにより、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 2003 と互換性のあるオブジェクトモデルで動作するマネージコードフォームテンプレートの InfoPath オブジェクトモデルと一般的なプログラミングタスクについては、「 InfoPath 2003 オブジェクトモデルについて」を参照してください。

フィードバック

このページはお役に立ちましたか?

Last updated on 2023-04-04

チュートリアル: InfoPath オブジェクト モデルを使用して基本的なフォーム テンプレートを作成およびデバッグする

Hello World

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

OnClick イベント ハンドラーを設定したボタンを追加する

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

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

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

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

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

関連項目