View.GetContextNodes メソッド ()
現在の選択範囲内にある返された XML ノードに対して反復処理を行うための、XPathNodeIterator への参照を取得します。
名前空間: Microsoft.Office.InfoPath
アセンブリ: Microsoft.Office.InfoPath (microsoft.office.infopath.dll 内)
構文
'宣言
Public MustOverride Function GetContextNodes As XPathNodeIterator
'使用
Dim instance As View
Dim returnValue As XPathNodeIterator
returnValue = instance.GetContextNodes
public abstract XPathNodeIterator GetContextNodes ()
戻り値
現在の選択範囲内にあるノードが格納されている XPathNodeIterator。
例外処理
| 例外の種類 | 条件 |
|---|---|
GetContextNodes メソッドが Loading イベントのイベント ハンドラから呼び出されました。 |
コメント
GetContextNodes メソッドによって返される XML ノードは、ビューからマップされた一連のノードで構成され、選択された XSL 変換 (XSLT) ノードに対応しています。
選択したノードがビュー内の複数のコントロールにバインドされている場合は、このメソッドではなく、反復処理の対象とするノードにバインドされているコントロールの ViewContext 識別子を指定できる GetContextNodes メソッドを使用する必要があります。
.gif "メモ") メモ : |
|---|
GetContextNodes メソッドを、ビュー内のボタンの Clicked イベントのイベント ハンドラ内で使用すると、現在の選択範囲に基づくノードは返されません。これは、本来はコンテキスト内にあるコントロールからフォーカスが失われるためです。このような動作を回避するには、カスタム作業ウィンドウ、メニュー、またはツール バーの GetContextNodes メソッドを使用します。 |
このメンバは、現在開いているフォームと同じドメイン内で実行されているフォーム、またはドメインを越えたアクセス許可を付与されているフォームだけがアクセスできます。
この型またはメンバは、Microsoft Office InfoPath 2007 で開いているフォームで実行されているコードからのみアクセスできます。
例
次の例では、GetContextNodes メソッドを使用して、現在の選択内容に基づいてコンテキスト ノードのコレクションを返して XPathNodeIterator オブジェクト変数に保存します。次に、コンテキスト ノードのコレクションにループ処理を実行して、各ノードの名前、内部 XML、および値を表示します。
// Get context nodes in current selection.
XPathNodeIterator contextNodes =
CurrentView.GetContextNodes();
// Loop through collection and display information.
foreach (XPathNavigator contextNode in contextNodes)
{
MessageBox.Show(contextNode.Name);
MessageBox.Show(contextNode.InnerXml);
MessageBox.Show(contextNode.Value);
}
' Get context nodes in current selection.
Dim contextNodes As XPathNodeIterator = _
CurrentView.GetContextNodes(repeatingTableRow1)
' Loop through collection and display information.
Dim contextNode As XPathNavigator
For Each contextNode In contextNodes
MessageBox.Show(contextNode.Name)
MessageBox.Show(contextNode.InnerXml)
MessageBox.Show(contextNode.Value)
Next