View.ExecuteAction(String, Object) Méthode

Référence

Définition

Espace de noms:: Microsoft.Office.Interop.InfoPath

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

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Exécute une commande d’édition Microsoft Office InfoPath 2003 sur le document XML sous-jacent d’un formulaire, en fonction des données sélectionnées dans la vue.

public void ExecuteAction (string bstrAction, object varXmlToEdit);

abstract member ExecuteAction : string * obj -> unit

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

Paramètres

bstrAction: String

Nom de l'action d'édition à effectuer.

varXmlToEdit: Object

Nom du champ ou du groupe auquel appliquer l'action d'édition. Cet argument est équivalent à la valeur de l'attribut name dans l'élément xmlToEdit du fichier de définition de formulaire (.xsf).

Exemples

Dans l’exemple suivant, la méthode ExecuteAction de l’objet ViewObject est utilisée pour supprimer les données sélectionnées et les placer dans le Presse-papiers :

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

Dans l’exemple suivant, la méthode ExecuteAction de l’objet ViewObject est utilisée pour insérer des données à l’aide du composant d’édition xCollection, en fonction du contexte sélectionné :

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

Remarques

La méthode ExecuteAction est utilisée pour effectuer, par programmation, des actions d'édition InfoPath 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).

Il est possible de définir d’abord le contexte de sélection à l’aide de la méthode ou SelectText(IXMLDOMNode, Object) de la SelectNodes(IXMLDOMNode, Object, Object) méthode , puis d’appeler la méthode ExecuteAction pour agir sur ce contexte.

La méthode ExecuteAction renvoie une erreur pour les raisons suivantes :

Le bstrAction paramètre ne contient pas de nom de composant d’édition valide.
Le varXmlToEdit paramètre ne correspond pas à un composant d’édition défini dans la vue.
Le varXmlToEdit paramètre est requis pour une action de modification spécifique.
L'action d'édition n'est pas applicable au contexte sélectionné.
Le tableau suivant contient des combinaisons de paramètres qui peuvent être utilisées avec la méthode ExecuteAction.

« Copier »	Copie les données sélectionnées dans le Presse-papiers.
« Coller »	Copie les données du Presse-papiers vers le point d'insertion.
« Couper »	Supprime les données sélectionnées et les copie dans le Presse-papiers.
« Supprimer »	Supprime les données sélectionnées.
« xCollection::insert », « `xmlToEdit` »	Insère les données basées sur le contexte sélectionné, à l'aide du composant editing xCollection. Si la sélection actuelle se trouve dans un conteneur du composant xCollection, spécifié par son élément xmlToEdit dans le fichier .xsf, les données de l'élément fragmentToInsert sont ajoutées dans ce conteneur.
« xCollection::insertBefore », « `xmlToEdit` »	Insère des données avant le contexte sélectionné, à l'aide du composant editing xCollection. Si la sélection actuelle se trouve dans un élément du composant xCollection, comme spécifié par son élément xmlToEdit dans le fichier .xsf, les données de l'élément fragmentToInsert sont insérées avant cet élément.
« xCollection::insertAfter », « `xmlToEdit` »	Insère des données après le contexte sélectionné, à l'aide du composant editing xCollection. Si la sélection actuelle se trouve dans un élément du composant xCollection, comme spécifié par son élément xmlToEdit dans le fichier .xsf, les données de l'élément fragmentToInsert sont insérées après cet élément.
« xCollection::remove », « `xmlToEdit` »	Supprime des données du contexte sélectionné, à l'aide du composant editing xCollection. Si la sélection actuelle se trouve dans un élément du composant xCollection, comme spécifié par son élément xmlToEdit dans le fichier .xsf, cet élément est supprimé.
« xCollection::removeAll », « `xmlToEdit` »	Supprime toutes les données contenues dans le contexte sélectionné, à l'aide du composant editing xCollection. Si la sélection actuelle se trouve dans un conteneur du composant xCollection, comme spécifié par l'élément xmlToEdit dans le fichier .xsf, cette action supprime tous les éléments de ce conteneur.
« xReplace::replace », « `xmlToEdit` »	Remplace les données du contexte sélectionné à l'aide du composant editing xReplace. Si la sélection actuelle se trouve dans un élément du composant xReplace, comme spécifié par son élément xmlToEdit dans le fichier .xsf, cet élément est remplacé par les données de l'élément fragmentToInsert.
« xOptional::insert », « `xmlToEdit` »	Insère des données basées sur le contexte sélectionné, à l'aide du composant editing xOptional. Si la sélection actuelle se trouve dans un conteneur du composant xOptional, comme spécifié par son élément xmlToEdit dans le fichier .xsf, les données de l'élément fragmentToInsert sont ajoutées dans ce conteneur.
« xOptional::remove », « `xmlToEdit` »	Supprime des données du contexte sélectionné à l'aide du composant editing xOptional. Si la sélection actuelle se trouve dans un élément du composant xOptional, comme spécifié par son élément xmlToEdit dans le fichier .xsf, cet élément est supprimé.

Remarque Dans certains cas, l’appel de la méthode ExecuteAction à partir du OnClick pour un bouton dans une 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 lien) dans un volet Office personnalisé, une barre d'outils ou un menu pour appeler la méthode ExecuteAction.

S’applique à

Partager via