View.ExecuteAction-Methode (ActionType)
Führt basierend auf den Daten, die zurzeit in der Ansicht ausgewählt sind, einen Bearbeitungsbefehl für das einem Formular zugrunde liegende XML-Dokument aus.
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in microsoft.office.infopath.dll)
Syntax
'Declaration
Public MustOverride Sub ExecuteAction ( _
action As ActionType _
)
'Usage
Dim instance As View
Dim action As ActionType
instance.ExecuteAction(action)
public abstract void ExecuteAction (
ActionType action
)
Parameter
- action
Eine ActionType-Enumeration, die die auszuführende Aktion angibt.
Ausnahmen
| Ausnahmetyp | Bedingung |
|---|---|
Die ExecuteAction-Methode wurde aus einem Ereignishandler für das Loading-Ereignis aufgerufen. |
|
Der an diese Methode übergebene Parameter lautet null. |
|
Der an diese Methode übergebene Parameter ist nicht gültig. Der Parameter weist beispielsweise den falschen Typ oder das falsche Format auf. |
Hinweise
Die ExecuteAction-Methode wird verwendet, um integrierte Bearbeitungsaktionen für das einem Formular zugrunde liegende XML-Dokument, basierend auf dem in einer Ansicht ausgewählten Kontext, programmgesteuert auszuführen.
Die ausgeführte Aktion ist mit der Aktion identisch, die beim Klicken auf einen entsprechenden Menübefehl oder eine entsprechende Symbolleisten-Schaltfläche ausgeführt wird. Sie entspricht also der Aktion, bei der das Schaltflächenelement in der XSF-Datei entsprechende Werte für die Attribute xmlToEdit und action aufweist. Wie bei der Verwendung einer Schaltfläche wird die Aktion für den ausgewählten Kontext ausgeführt (sollte die Auswahl bewirken, dass die Schaltfläche deaktiviert wird, hat die ExecuteAction-Methode keine Auswirkung).
Es ist möglich, zuerst den Auswahlkontext mithilfe der Methoden SelectNodes oder SelectText festzulegen und dann die ExecuteAction-Methode aufzurufen, um eine Aktion für diesen Kontext auszuführen.
Hinweis
In einigen Fällen kann das Aufrufen der ExecuteAction-Methode aus einem Ereignishandler für das Clicked-Ereignis einer Schaltfläche in der Ansicht einen Fehler verursachen. Dies liegt daran, dass der ausgewählte Kontext der Schaltfläche sich ändert, sobald auf sie geklickt wird. In diesem Fall empfiehlt es sich, eine Schaltfläche oder eine Verknüpfung in einem benutzerdefinierten Aufgabenbereich, in einem benutzerdefinierten Menü oder auf einer benutzerdefinierten Symbolleiste zu verwenden, um die ExecuteAction-Methode aufzurufen.
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 wird die ExecuteAction(action)-Methode der View-Klasse verwendet, um die aktuell ausgewählten Daten zu löschen und in der Zwischenablage abzulegen.
// Create XPathNavigator and select field.
XPathNavigator textNode =
CreateNavigator().SelectSingleNode(
"/my:myFields/my:field1", NamespaceManager);
// Select text in specified field.
CurrentView.SelectText(textNode);
// Cut selected text.
CurrentView.ExecuteAction(ActionType.Cut);
' Create XPathNavigator and select field.
Dim textNode As XPathNavigator = _
CreateNavigator().SelectSingleNode( _
"/my:myFields/my:field1", NamespaceManager)
' Select text in specified field.
CurrentView.SelectText(textNode)
' Cut selected text.
CurrentView.ExecuteAction(ActionType.Cut)