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
選択するテキストを指定する XPathNavigator オブジェクト。
- viewContext
選択するテキストが含まれているコントロールの ViewContext 識別子。
例外処理
| 例外の種類 | 条件 |
|---|---|
SelectText メソッドが、Loading イベントのイベント ハンドラから呼び出されました。 |
|
このメソッドに渡されたパラメータは null です。 |
|
このメソッドに渡されたパラメータは有効ではありません。たとえば、型または形式が正しくありません。 |
コメント
指定したテキストがビュー内の複数のコントロールとバインドされている場合は、選択するテキストが入っているコントロールの ViewContext 識別子を指定する必要があります。コントロールの ViewContext 識別子を調べるには、フォーム テンプレートをデザイン モードで開き、コントロールの [プロパティ] ダイアログ ボックスを表示して [詳細設定] タブをクリックします。
ViewContext 識別子を指定する場合は、選択されるテキストがそのコンテキスト内にある必要があります。
SelectText メソッドのいずれかの引数が null になっているか、またはビュー内に出現しない場合にも、SelectText メソッドは例外を発生させます。
このメンバは、現在開いているフォームと同じドメイン内で実行されているフォーム、またはドメインを越えたアクセス許可を付与されているフォームだけがアクセスできます。
この型またはメンバは、Microsoft Office InfoPath 2007 で開いているフォームで実行されているコードからのみアクセスできます。
例
次の例では、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")