View.ExecuteAction(String, Object) Methode

Referenz

Definition

Namespace:: Microsoft.Office.Interop.InfoPath.SemiTrust

Assembly:: Microsoft.Office.Interop.InfoPath.SemiTrust.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Führt einen Microsoft InfoPath-Bearbeitungsbefehl für das einem Formular zugrunde liegende XML-Dokument aus, basierend auf den in der Ansicht ausgewählten Daten.

public:
 void ExecuteAction(System::String ^ bstrAction, System::Object ^ varXmlToEdit);

public void ExecuteAction (string bstrAction, object varXmlToEdit);

abstract member ExecuteAction : string * obj -> unit

Public Sub ExecuteAction (bstrAction As String, varXmlToEdit As Object)

Parameter

bstrAction: String

Der Name der auszuführenden Bearbeitungsaktion.

varXmlToEdit: Object

Der Name des Felds oder der Gruppe, auf das bzw. die die Bearbeitungsaktion angewendet werden soll. Dies entspricht dem Wert des Name-Attributs im xmlToEdit-Element der Formulardefinitionsdatei (XSF).

Beispiele

Im folgenden Beispiel wird die ExecuteAction-Methode des ViewObject Objekts verwendet, um ausgewählte Daten zu löschen und in der Zwischenablage zu platzieren:

thisXDocument.View.<span class="label">ExecuteAction</span>("Cut", Type.Missing);

Im folgenden Beispiel wird die ExecuteAction-Methode des ViewObject -Objekts verwendet, um Daten mithilfe der xCollection-Bearbeitungskomponente basierend auf dem ausgewählten Kontext einzufügen:

thisXDocument.View.<span class="label">ExecuteAction</span>("xCollection::insert", "group1_1");

Hinweise

Die ExecuteAction-Methode wird verwendet, um, basierend auf dem in einer Ansicht ausgewählten Kontext, integrierte InfoPath-Bearbeitungsaktionen für das einem Formular zugrunde liegende XML-Dokument programmgesteuert auszuführen.

Bei der ausgeführten Aktion handelt es sich um die gleiche Aktion, die beim Klicken auf ein entsprechendes Menü oder eine Entsprechende Symbolleistenschaltfläche verwendet wird. nämlich eine, für die das Schaltflächenelement in der XSF-Datei die entsprechenden xmlToEdit - und action-Attribute aufweist. Wie bei der Verwendung einer Schaltfläche basiert die Aktion auf der aktuellen Auswahl: Sie wirkt auf den ausgewählten Kontext (und wenn die Auswahl dazu führen würde, dass die Schaltfläche deaktiviert wird, hat die ExecuteAction-Methode keine Auswirkungen).

Es ist möglich, zuerst den Auswahlkontext mithilfe der -Methode oder SelectText(IXMLDOMNode, Object) -SelectNodes(IXMLDOMNode, Object, Object)Methode festzulegen und dann die ExecuteAction-Methode aufzurufen, um auf diesen Kontext zu reagieren.

In den folgenden Situationen gibt die ExecuteAction-Methode einen Fehler zurück:

Der bstrAction Parameter enthält keinen gültigen Bearbeitungskomponentennamen.
Der varXmlToEdit Parameter stimmt nicht mit einer Bearbeitungskomponente überein, die in der Ansicht definiert ist.
Der varXmlToEdit Parameter ist für eine bestimmte Bearbeitungsaktion erforderlich.
Die Bearbeitungsaktion kann auf den ausgewählten Kontext nicht angewendet werden.
In der folgenden Tabelle sind die Parameterkombinationen aufgeführt, die bei der ExecuteAction-Methode verwendet werden können.

"Kopieren"	Kopiert die ausgewählten Daten in die Zwischenablage.
"Einfügen"	Kopiert die Daten aus der Zwischenablage an die Position der Einfügemarke.
"Ausschneiden"	Entfernt die ausgewählten Daten und kopiert sie in die Zwischenablage.
"Löschen"	Löscht die ausgewählten Daten.
"xCollection::insert", "`xmlToEdit`"	Fügt Daten, basierend auf dem ausgewählten Kontext, mithilfe der xCollection-Bearbeitungskomponente ein. Wenn sich die aktuelle Auswahl in einem Container der xCollection-Komponente befindet, wie durch das xmlToEdit-Element in der XSF-Datei angegeben, werden die Daten des fragmentToInsert-Elements innerhalb dieses Containers angefügt.
"xCollection::insertBefore", "`xmlToEdit`"	Fügt Daten mithilfe der xCollection-Bearbeitungskomponente vor dem ausgewählten Kontext ein. Wenn sich die aktuelle Auswahl innerhalb eines Elements der xCollection-Komponente befindet, wie durch das xmlToEdit-Element in der XSF-Datei angegeben, werden die Daten des fragmentToInsert-Elements vor diesem Element eingefügt.
"xCollection::insertAfter", "`xmlToEdit`"	Fügt Daten mithilfe der xCollection-Bearbeitungskomponente hinter dem ausgewählten Kontext ein. Wenn sich die aktuelle Auswahl innerhalb eines Elements der xCollection-Komponente befindet, wie durch das xmlToEdit-Element in der XSF-Datei angegeben, werden die Daten des fragmentToInsert-Elements hinter diesem Element eingefügt.
"xCollection::remove", "`xmlToEdit`"	Löscht Daten mithilfe der xCollection-Bearbeitungskomponente aus dem ausgewählten Kontext. Wenn sich die aktuelle Auswahl innerhalb eines Elements der xCollection-Komponente befindet, wie durch das xmlToEdit-Element in der XSF-Datei angegeben, wird dieses Element gelöscht.
"xCollection::removeAll", "`xmlToEdit`"	Löscht alle Daten im ausgewählten Kontext mithilfe der xCollection-Bearbeitungskomponente. Wenn sich die aktuelle Auswahl in einem Container der xCollection-Komponente befindet, wie durch das xmlToEdit-Element in der XSF-Datei angegeben, löscht diese Aktion alle Elemente in diesem Container.
"xReplace::replace", "`xmlToEdit`"	Ersetzt die Daten im ausgewählten Kontext mithilfe der xReplace-Bearbeitungskomponente. Wenn sich die aktuelle Auswahl innerhalb eines Elements der xReplace-Komponente befindet, wie durch das xmlToEdit-Element in der XSF-Datei angegeben, wird dieses Element durch die Daten des fragmentToInsert-Elements ersetzt.
"xOptional::insert", "`xmlToEdit`"	Fügt Daten, basierend auf dem ausgewählten Kontext, mithilfe der xOptional-Bearbeitungskomponente ein. Wenn sich die aktuelle Auswahl in einem Container der xOptional-Komponente befindet, wie durch das xmlToEdit-Element in der XSF-Datei angegeben, werden die Daten des fragmentToInsert-Elements innerhalb dieses Containers angefügt.
"xOptional::remove", "`xmlToEdit`"	Löscht Daten mithilfe der xOptional-Bearbeitungskomponente aus dem ausgewählten Kontext. Wenn sich die aktuelle Auswahl innerhalb eines Elements der xOptional-Komponente befindet, wie durch das xmlToEdit-Element in der XSF-Datei angegeben, wird dieses Element gelöscht.

Hinweis In einigen Fällen kann das Aufrufen der ExecuteAction-Methode aus für OnClick eine Schaltfläche in einer Ansicht zu einem Fehler führen. Dies liegt daran, dass die Schaltfläche zum ausgewählten Kontext wird, sobald auf sie geklickt wird. In diesem Fall empfiehlt es sich, eine Schaltfläche (oder eine Verknüpfung) in einem benutzerdefinierten Aufgabenbereich, auf einer benutzerdefinierten Symbolleiste oder in einem benutzerdefinierten Menü zu verwenden, um die ExecuteAction-Methode aufzurufen.

Wichtig: Auf dieses Mitglied kann nur über Formulare zugegriffen werden, die in derselben Domäne wie das aktuell geöffnete Formular ausgeführt werden, oder über Formulare, denen domänenübergreifende Berechtigungen erteilt wurden.

Gilt für:

Freigeben über