View.SelectText 方法

定义

命名空间:

Microsoft.Office.InfoPath

程序集:

Microsoft.Office.InfoPath.dll

重载

SelectText(XPathNavigator)	选择可编辑控件中包含的文本，该控件绑定到传递给此方法的对象 XPathNavigator 指定的节点。
SelectText(XPathNavigator, String)	选择可编辑控件中包含的文本，该控件绑定到由 控件的对象 XPathNavigator 和 ViewContext 标识符指定的节点。

SelectText(XPathNavigator)

选择可编辑控件中包含的文本，该控件绑定到传递给此方法的对象 XPathNavigator 指定的节点。

public:
 abstract void SelectText(System::Xml::XPath::XPathNavigator ^ xmlNode);

public abstract void SelectText (System.Xml.XPath.XPathNavigator xmlNode);

abstract member SelectText : System.Xml.XPath.XPathNavigator -> unit

Public MustOverride Sub SelectText (xmlNode As XPathNavigator)

参数

xmlNode

XPathNavigator

用于指定要选择的文本的对象。

例外

InvalidOperationException

从事件的事件处理程序Loading调用了 SelectText 方法。

ArgumentNullException

传递给此方法的参数是一个 null 引用， (Visual Basic) 中无任何内容。

ArgumentException

传递给此方法的参数无效。 例如，它的类型或格式有误。

示例

在以下示例中， SelectText (xmlNode) 方法用于选择 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)

注解

如果指定文本绑定到视图中的多个控件，那么使用此 SelectText 方法将会引发异常。 若要避免这种情况，必须使用 SelectText(XPathNavigator, String) 方法，该方法允许指定包含要选择的文本的控件的 ViewContext 标识符。

此外，如果 SelectText 方法的参数是 null 引用 (Visual Basic) 或未在视图中公开，则 SelectText 方法也会引发异常。

此成员只能由与当前打开的表单在相同域中运行的表单访问，或者由已授予跨域权限的表单访问。

可以通过 Microsoft InfoPath Filler 或 Web 浏览器内打开的表单中运行的代码访问此类型或成员。

SelectText(XPathNavigator, String)

选择可编辑控件中包含的文本，该控件绑定到由 控件的对象 XPathNavigator 和 ViewContext 标识符指定的节点。

public:
 abstract void SelectText(System::Xml::XPath::XPathNavigator ^ xmlNode, System::String ^ viewContext);

public abstract void SelectText (System.Xml.XPath.XPathNavigator xmlNode, string viewContext);

abstract member SelectText : System.Xml.XPath.XPathNavigator * string -> unit

Public MustOverride Sub SelectText (xmlNode As XPathNavigator, viewContext As String)

参数

xmlNode

XPathNavigator

用于指定要选择的文本的对象。

viewContext

String

要在其中选择文本的控件的 ViewContext 标识符。

例外

InvalidOperationException

从事件的事件处理程序Loading调用了 SelectText 方法。

ArgumentNullException

传递给此方法的参数是 null 引用， (Visual Basic) 中没有。

ArgumentException

传递给此方法的参数无效。 例如，它们的类型或格式有误。

示例

在以下示例中，field1 绑定到多个控件，其中一个控件的 ViewContext 标识符为“CTRL2”。 SelectText (xmlnode，viewContext) 方法用于从 ViewContext 标识符为“CTRL2”的控件中选择 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")

注解

如果指定文本绑定到视图中的多个控件，您必须提供要从中选择文本的控件的 ViewContext 标识符。 可以通过在设计模式下打开表单模板，显示控件的“属性”对话框，然后单击“高级”选项卡，来确定控件的 ViewContext 标识符。

在指定 ViewContext 标识符时，要选择的文本必须位于该上下文内。

如果 SelectText 方法的任何参数是 null 引用 (Visual Basic) 中没有内容，或者未在视图中公开，则 SelectText 方法也会引发异常。

此成员只能由与当前打开的表单在相同域中运行的表单访问，或者由已授予跨域权限的表单访问。

可以通过 Microsoft InfoPath Filler 或 Web 浏览器内打开的表单中运行的代码访问此类型或成员。