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
Ein XPathNavigator-Objekt, das den auszuwählenden Text angibt.
- viewContext
Der ViewContext-Bezeichner für das Steuerelement, in dem Text ausgewählt werden soll.
Ausnahmen
| Ausnahmetyp | Bedingung |
|---|---|
Die SelectText-Methode wurde aus einem Ereignishandler für das Loading-Ereignis aufgerufen. |
|
Die an diese Methode übergebenen Parameter sind null. |
|
Die an diese Methode übergebenen Parameter sind ungültig. Sie weisen z. B. 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 null 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 nur über Code zugegriffen werden, der in Formularen ausgeführt wird, die mit Microsoft Office InfoPath 2007 geöffnet wurden.
Beispiel
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")