This topic has not yet been rated - Rate this topic

View.SelectText method (XPathNavigator, String)

Office 2013

Office 2010

This documentation is preliminary and is subject to change.

Selects the text contained in an editable control that is bound to the node specified by the XPathNavigator object and ViewContext identifier of the control.

Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)

Syntax

public abstract void SelectText(
	XPathNavigator xmlNode,
	string viewContext
)

Parameters

xmlNode: Type: System.Xml.XPath.XPathNavigator
An object that specifies the text to select.

viewContext: Type: System.String
The ViewContext identifier for the control in which to select text.

Exceptions

Exception	Condition
InvalidOperationException	The SelectText method was called from an event handler for the Loading event.
ArgumentNullException	The parameters passed to this method are null.
ArgumentException	The parameters passed to this method are not valid. For example, they are of the wrong type or format.

Remarks

If the specified text is bound to more than one control in the view, you must provide the ViewContext identifier of the control to select text from. You can determine the ViewContext identifier for a control by opening the form template in Design mode, displaying the control's Properties dialog box, and then clicking the Advanced tab.

When the ViewContext identifier is specified, the text that is to be selected must be within that context.

If any of the arguments to the SelectText method are null or are 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, field1 is bound to more than one control, one of which has the ViewContext identifier of "CTRL2". The SelectText(xmlnode,viewContext) method is used to select the text in field1 from the control with the ViewContext identifier of "CTRL2".

// Create XPathNavigator and select field.
XPathNavigator textNode = 
   CreateNavigator().SelectSingleNode(
   "/my:myFields/my:field1", NamespaceManager);

// Select text in specified field.
CurrentView.SelectText(textNode, "CTRL2");

Reference

View class

View members

SelectText overload

Microsoft.Office.InfoPath namespace

Did you find this helpful? Yes No

Not accurate

Not enough depth

Need more code examples

(1500 characters remaining)

Community Additions

ADD