View.ExecuteAction Méthode

public:
 abstract void ExecuteAction(Microsoft::Office::InfoPath::ActionType action);

public abstract void ExecuteAction (Microsoft.Office.InfoPath.ActionType action);

abstract member ExecuteAction : Microsoft.Office.InfoPath.ActionType -> unit

Public MustOverride Sub ExecuteAction (action As ActionType)

Paramètres

Exceptions

Exemples

Dans l’exemple suivant, la méthode ExecuteAction(action) de la View classe 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)

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 définir d’abord le contexte de sélection à l’aide de la méthode ou SelectText de la SelectNodes méthode , puis d’appeler la méthode ExecuteAction pour agir sur ce contexte.

Remarque : 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 la vue peut entraîner 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.

Seuls les formulaires qui s’exécutent dans le même domaine que le formulaire actuellement ouvert ou les formulaires disposant d’autorisations inter-domaines peuvent accéder à ce membre.

Vous pouvez uniquement accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler.

public:
 abstract void ExecuteAction(Microsoft::Office::InfoPath::ActionType action, System::String ^ xmlToEdit);

public abstract void ExecuteAction (Microsoft.Office.InfoPath.ActionType action, string xmlToEdit);

abstract member ExecuteAction : Microsoft.Office.InfoPath.ActionType * string -> unit

Public MustOverride Sub ExecuteAction (action As ActionType, xmlToEdit As String)

Paramètres

Exceptions

Exemples

Dans l’exemple suivant, la méthode ExecuteAction(action, xmlToEdit) de la View classe est utilisée pour insérer des données dans le groupe spécifié à l’aide de l’action ActionType.XCollectionInsert .

this.CurrentView.ExecuteAction(ActionType.XCollectionInsert, 
   "group1_1");

Me.CurrentView.ExecuteAction(ActionType.XCollectionInsert, "group1_1")

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, l’action est basée sur la sélection active : 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).

Vous pouvez déterminer l’identificateur XmlToEdit d’un contrôle ou d’un groupe sur un formulaire InfoPath dans le Designer en affichant la boîte de dialogue Propriétés du contrôle, puis en cliquant sur l’onglet Avancé.

Remarque : 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 la vue peut entraîner 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.

Seuls les formulaires qui s’exécutent dans le même domaine que le formulaire actuellement ouvert ou les formulaires disposant d’autorisations inter-domaines peuvent accéder à ce membre.

Vous pouvez uniquement accéder à ce type ou à ce membre à partir du code exécuté dans les formulaires ouverts dans Microsoft InfoPath Filler.