View.ExecuteAction, méthode (ActionType)
Exécute une commande d’édition sur le document XML sous-jacent d’un formulaire, sur la base des données sélectionnées dans la vue.
Espace de noms : Microsoft.Office.InfoPath
Assembly : Microsoft.Office.InfoPath (dans Microsoft.Office.InfoPath.dll)
Syntaxe
'Déclaration
Public MustOverride Sub ExecuteAction ( _
action As ActionType _
)
'Utilisation
Dim instance As View
Dim action As ActionType
instance.ExecuteAction(action)
public abstract void ExecuteAction(
ActionType action
)
Paramètres
- action
Type : Microsoft.Office.InfoPath.ActionType
Énumération ActionType qui spécifie l’action à effectuer.
Exceptions
| Exception | Condition |
|---|---|
| InvalidOperationException | La méthode ExecuteAction a été appelée depuis un gestionnaire d’événements pour l’événement Loading. |
| ArgumentNullException | Le paramètre transmis à cette méthode est une référence NULL (Nothing dans Visual Basic). |
| ArgumentException | Le paramètre passé à cette méthode n’est pas valide. Par exemple, le type ou le format est incorrect. |
Remarques
La méthode ExecuteAction est utilisée pour effectuer, par programmation, des actions d’édition prédéfinies dans le document XML sous-jacent d’un formulaire, sur la base du contexte sélectionné dans une vue.
L’action exécutée est la même que celle utilisée lorsque vous cliquez sur un menu ou un bouton de barre d’outils équivalent, à savoir celle pour laquelle l’élément bouton du fichier .xsf possède les attributs xmlToEdit et action correspondants. Comme lors de l’utilisation d’un bouton, elle agit sur le contexte sélectionné (et dans le cas où la sélection entraîne la désactivation du bouton, la méthode ExecuteAction est sans effet).
Il est possible de commencer par définir le contexte de sélection en utilisant la méthode SelectNodes ou la méthode SelectText, puis d’appeler la méthode ExecuteAction pour agir sur ce contexte.
Notes
Dans certains cas, l’appel de la méthode ExecuteAction à partir d’un gestionnaire d’événements pour l’événement Clicked d’un bouton dans une vue peut générer une erreur. Cela est dû au fait que le contexte sélectionné est remplacé par le bouton lorsque celui-ci est activé. Dans ce cas, il est préférable d’utiliser un bouton ou un lien dans un volet Office personnalisé, un menu ou une barre d’outils pour appeler la méthode ExecuteAction.
Ce membre est accessible uniquement par les formulaires qui s’exécutent dans le même domaine que le formulaire ouvert ou par les formulaires qui disposent d’autorisations valables pour plusieurs domaines.
Ce type ou ce membre est accessible uniquement à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler.
Exemples
Dans l’exemple qui suit, la méthode ExecuteAction(action) de la classe View est utilisée pour supprimer les données actuellement sélectionnées et les placer dans le Presse-papiers.
// 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)