View.SelectText メソッド (XPathNavigator, String)
XPathNavigator オブジェクトとコントロールの ViewContext 識別子で指定されたノードにバインドされている編集可能コントロールに含まれているテキストを選択します。
名前空間: Microsoft.Office.InfoPath
アセンブリ: Microsoft.Office.InfoPath (Microsoft.Office.InfoPath.dll)
構文
'宣言
Public MustOverride Sub SelectText ( _
xmlNode As XPathNavigator, _
viewContext As String _
)
'使用
Dim instance As View
Dim xmlNode As XPathNavigator
Dim viewContext As String
instance.SelectText(xmlNode, viewContext)
public abstract void SelectText(
XPathNavigator xmlNode,
string viewContext
)
パラメーター
- xmlNode
型: System.Xml.XPath.XPathNavigator
選択するテキストを指定するオブジェクト。
- viewContext
型: System.String
選択するテキストが含まれているコントロールの ViewContext 識別子。
例外
| 例外 | 条件 |
|---|---|
| InvalidOperationException | SelectText メソッドが、Loading イベントのイベント ハンドラーから呼び出されました。 |
| ArgumentNullException | このメソッドに渡されたパラメーターは null 参照 (Visual Basic ではNothing ) です。 |
| ArgumentException | このメソッドに渡されたパラメーターは有効ではありません。たとえば、型または形式が正しくありません。 |
解説
指定したテキストがビュー内の複数のコントロールとバインドされている場合は、選択するテキストが入っているコントロールの ViewContext 識別子を指定する必要があります。コントロールの ViewContext 識別子を調べるには、フォーム テンプレートをデザイン モードで開き、コントロールの [プロパティ] ダイアログ ボックスを表示して [詳細設定] タブをクリックします。
ViewContext 識別子を指定する場合は、選択されるテキストがそのコンテキスト内にある必要があります。
SelectText メソッドのいずれかの引数が null 参照 (Visual Basic ではNothing ) になっているか、またはビュー内に出現しない場合にも、SelectText メソッドは例外を発生させます。
このメンバーには、現在開いているフォームと同じドメインで実行中のフォーム、またはクロスドメインのアクセス許可が与えられたフォームのみがアクセスできます。
この型またはメンバーには、Microsoft InfoPath Filler または Web ブラウザーで開かれたフォームを実行中のコードからアクセスできます。
例
次の例では、field1 が複数のコントロールにバインドされており、そのうちの 1 つが "CTRL2" という ViewContext 識別子を持っています。そして、SelectText(xmlnode,viewContext) メソッドを使用して、"CTRL2" という ViewContext 識別子を持つコントロールの field1 内のテキストを選択しています。
// Create XPathNavigator and select field.
XPathNavigator textNode =
CreateNavigator().SelectSingleNode(
"/my:myFields/my:field1", NamespaceManager);
// Select text in specified field.
CurrentView.SelectText(textNode, "CTRL2");
' Create XPathNavigator and select field.
Dim textNode As XPathNavigator = _
CreateNavigator().SelectSingleNode( _
"/my:myFields/my:field1", NamespaceManager)
' Select text in specified field.
CurrentView.SelectText(textNode, "CTRL2")