View.SelectText Methode

Definition

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Überlädt

SelectText(XPathNavigator)	Markiert den Text, der in einem bearbeitbaren Steuerelement enthalten ist, das an den Knoten gebunden ist, der durch das XPathNavigator an diese Methode übergebene Objekt angegeben wird.
SelectText(XPathNavigator, String)	Markiert den Text, der in einem bearbeitbaren Steuerelement enthalten ist, das an den Knoten gebunden ist, der durch das -Objekt und den XPathNavigatorViewContext-Bezeichner des Steuerelements angegeben wird.

SelectText(XPathNavigator)

Markiert den Text, der in einem bearbeitbaren Steuerelement enthalten ist, das an den Knoten gebunden ist, der durch das XPathNavigator an diese Methode übergebene Objekt angegeben wird.

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)

Parameter

xmlNode

XPathNavigator

Ein Objekt, das den auszuwählenden Text angibt.

Ausnahmen

InvalidOperationException

Die SelectText-Methode wurde von einem Ereignishandler für das Loading Ereignis aufgerufen.

ArgumentNullException

Der an diese Methode übergebene Parameter ist ein NULL-Verweis (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.

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)

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 text enthält, den Sie auswählen möchten.

Wenn das Argument für die SelectText-Methode ein NULL-Verweis ist (Nothing in Visual Basic) oder nicht in der Ansicht verfügbar gemacht wird, löst die SelectText-Methode auch eine Ausnahme aus.

Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.

Auf diesen Typ oder dieses Mitglied kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler oder in einem Webbrowser geöffnet wurden.

SelectText(XPathNavigator, String)

Markiert den Text, der in einem bearbeitbaren Steuerelement enthalten ist, das an den Knoten gebunden ist, der durch das -Objekt und den XPathNavigatorViewContext-Bezeichner des Steuerelements angegeben wird.

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)

Parameter

xmlNode

XPathNavigator

Ein Objekt, das den auszuwählenden Text angibt.

viewContext

String

Der ViewContext-Bezeichner für das Steuerelement, in dem Text ausgewählt werden soll.

Ausnahmen

InvalidOperationException

Die SelectText-Methode wurde von einem Ereignishandler für das Loading Ereignis aufgerufen.

ArgumentNullException

Die an diese Methode übergebenen Parameter sind ein NULL-Verweis (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.

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 "STRG2" 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")

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 ermitteln, 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 für die SelectText-Methode ein NULL-Verweis (Nothing in Visual Basic) ist oder in der Ansicht nicht verfügbar gemacht wird, löst die SelectText-Methode auch eine Ausnahme aus.

Auf dieses Mitglied kann nur mithilfe von Formularen zugegriffen werden, die in der gleichen Domäne wie das derzeit geöffnete Formular ausgeführt werden oder denen domänenübergreifende Berechtigungen zugewiesen wurden.

Auf diesen Typ oder dieses Mitglied kann über Code zugegriffen werden, der in Formularen ausgeführt wird, die in Microsoft InfoPath Filler oder in einem Webbrowser geöffnet wurden.