View.SelectText-Methode (XPathNavigator, String)
Wählt den Text in einem bearbeitbaren Steuerelement aus, das an den Knoten gebunden ist, der durch das XPathNavigator-Objekt und den ViewContext-Bezeichner des Steuerelements angegeben wird.
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustOverride Sub SelectText ( _
xmlNode As XPathNavigator, _
viewContext As String _
)
'Usage
Dim instance As View
Dim xmlNode As XPathNavigator
Dim viewContext As String
instance.SelectText(xmlNode, viewContext)
public abstract void SelectText(
XPathNavigator xmlNode,
string viewContext
)
Parameter
- xmlNode
Typ: System.Xml.XPath.XPathNavigator
Ein Objekt, das den auszuwählenden Text angibt.
- viewContext
Typ: System.String
Der ViewContext-Bezeichner für das Steuerelement, in dem Text ausgewählt werden soll.
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| InvalidOperationException | Die SelectText-Methode wurde aus einem Ereignishandler für das Loading-Ereignis aufgerufen. |
| ArgumentNullException | Die an diese Methode übergebenen Parameter sind ein Nullverweis (Nothing in Visual Basic). |
| ArgumentException | Die an diese Methode übergebenen Parameter sind nicht gültig. Die Parameter weisen beispielsweise den falschen Typ oder das falsche Format auf. |
Hinweise
Wenn der angegebene Text an mehrere Steuerelemente in der Ansicht gebunden ist, müssen Sie den ViewContext-Bezeichner des Steuerelements bereitstellen, in dem Text ausgewählt werden soll. Sie können den ViewContext-Bezeichner für ein Steuerelement bestimmen, indem Sie die Formularvorlage im Entwurfsmodus öffnen, das Dialogfeld Eigenschaften des Steuerelements anzeigen und dann auf die Registerkarte Erweitert klicken.
Wenn der ViewContext-Bezeichner angegeben wird, muss sich der auszuwählende Text in diesem Kontext befinden.
Wenn eines der Argumente 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 ist field1 an mehrere Steuerelemente gebunden, von denen eins den ViewContext-Bezeichner "CTRL2" aufweist. Die SelectText(xmlnode,viewContext)-Methode wird verwendet, um den Text in field1 aus dem Steuerelement mit dem ViewContext-Bezeichner "CTRL2" auszuwählen.
// 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")