View.SelectText-Methode (XPathNavigator)
Wählt den Text in einem bearbeitbaren Steuerelement aus, das an den Knoten gebunden ist, der durch das an diese Methode übergebene XPathNavigator-Objekt angegeben wird.
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
)
Parameter
- xmlNode
Typ: System.Xml.XPath.XPathNavigator
Ein Objekt, das den auszuwählenden Text angibt.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| InvalidOperationException | Die SelectText-Methode wurde aus einem Ereignishandler für das Loading-Ereignis aufgerufen. |
| ArgumentNullException | Der an diese Methode übergebene Parameter lautet ein Nullverweis (Nothing in Visual Basic). |
| ArgumentException | Der an diese Methode übergebene Parameter ist nicht gültig. Der Parameter weist beispielsweise den falschen Typ oder das falsche Format auf. |
Hinweise
Wenn der angegebene Text an mehrere Steuerelemente in der Ansicht gebunden ist, wird durch das Verwenden dieser SelectText-Methode eine Ausnahme ausgelöst. Um dies zu vermeiden, müssen Sie die SelectText(XPathNavigator, String)-Methode verwenden, mit der Sie den ViewContext-Bezeichner des Steuerelements angeben können, das den auszuwählenden Text enthält.
Wenn das Argument der SelectText-Methode den Wert ein Nullverweis (Nothing in Visual Basic) hat oder in der Ansicht nicht verfügbar gemacht wird, löst die SelectText-Methode ebenfalls eine Ausnahme aus.
Auf den Member kann nur über Formulare zugegriffen werden, die in derselben Domäne wie das zurzeit geöffnete Formular ausgeführt werden, oder über Formulare, denen domänenübergreifende Berechtigungen erteilt wurden.
Auf diesen Typ oder diesen Member kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft InfoPath Filler oder einem Webbrowser geöffnet wurden.
Beispiele
Im folgenden Beispiel wird die SelectText(xmlNode)-Methode verwendet, um den Text in field1 auszuwählen.
// 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)