View.SelectText Method (XPathNavigator)
Selects the text contained in an editable control that is bound to the node specified by the XPathNavigator object passed to this method.
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustOverride Sub SelectText ( _
xmlNode As XPathNavigator _
)
'Usage
Dim instance As View
Dim xmlNode As XPathNavigator
instance.SelectText(xmlNode)
public abstract void SelectText(
XPathNavigator xmlNode
)
Parameters
xmlNode
Type: System.Xml.XPath.XPathNavigatorAn object that specifies the text to select.
Exceptions
| Exception | Condition |
|---|---|
| InvalidOperationException | The SelectText method was called from an event handler for the Loading event. |
| ArgumentNullException | The parameter passed to this method is a null reference (Nothing in Visual Basic). |
| ArgumentException | The parameter passed to this method is not valid. For example, it is of the wrong type or format. |
Remarks
If the specified text is bound to more than one control in the view, using this SelectText method will raise an exception. To avoid this, you must use the SelectText(XPathNavigator, String) method which allows you to specify the ViewContext identifier of the control that contains the text you want to select.
In addition, if the argument to the SelectText method is a null reference (Nothing in Visual Basic) or is not exposed in the view, then the SelectText method will also raise an exception.
This member can be accessed only by forms running in the same domain as the currently open form, or by forms that have been granted cross-domain permissions.
This type or member can be accessed from code running in forms opened in Microsoft InfoPath Filler or in a Web browser.
Examples
In the following example, the SelectText(xmlNode) method is used to select the text in field1.
// Create XPathNavigator and select field.
XPathNavigator textNode =
CreateNavigator().SelectSingleNode(
"/my:myFields/my:field1", NamespaceManager);
// Select text in specified field.
CurrentView.SelectText(textNode);
' Create XPathNavigator and select field.
Dim textNode As XPathNavigator = _
CreateNavigator().SelectSingleNode( _
"/my:myFields/my:field1", NamespaceManager)
' Select text in specified field.
CurrentView.SelectText(textNode)