ButtonEvent.Clicked, événement

Article
04/27/2010

Se produit lorsqu'un contrôle Bouton est activé dans une vue d'un formulaire.

Espace de noms : Microsoft.Office.InfoPath
Assembly : Microsoft.Office.InfoPath (dans microsoft.office.infopath.dll)

Syntaxe

Public Event Clicked As ClickedEventHandler

Dim instance As ButtonEvent
Dim handler As ClickedEventHandler

AddHandler instance.Clicked, handler

public abstract event ClickedEventHandler Clicked

Exceptions

Type d'exception	Condition
InvalidOperationException	Il est impossible de lier l'événement dans un emplacement autre que la méthode InternalStartup.
InvalidOperationException	Un seul délégué peut être ajouté à l'événement. Cette exception est générée si plusieurs délégués sont ajoutés au même ID de contrôle.

Remarques

Le gestionnaire de cet événement n'autorise pas l'annulation de l'événement.

Remarque
L'événement Clicked déclenché par le contrôle Bouton est le seul événement directement pris en charge par un contrôle d'un formulaire. Toutefois, la classe XmlEvent implémente des événements déclenchés lorsque des modifications sont apportées au document XML sous-jacent du formulaire. Vous pouvez, avec ces événements, créer des gestionnaires d'événements qui répondent aux modifications apportées à partir des contrôles liés aux nœuds et aux groupes du document XML sous-jacent d'un formulaire.

L'événement Clicked déclenché par le contrôle Bouton est le seul événement directement pris en charge par un contrôle d'un formulaire. Toutefois, la classe XmlEvent implémente des événements déclenchés lorsque des modifications sont apportées au document XML sous-jacent du formulaire. Vous pouvez, avec ces événements, créer des gestionnaires d'événements qui répondent aux modifications apportées à partir des contrôles liés aux nœuds et aux groupes du document XML sous-jacent d'un formulaire.

Exemple

L'exemple suivant suppose que vous disposez d'un contrôle Bouton et d'un contrôle Zone de texte lié au champ field1 de votre formulaire. Lorsque vous cliquez sur le contrôle Bouton, un objet XPathNavigator placé à la racine de la source de données principale du formulaire (document XML sous-jacent) est ouvert. Cet objet XPathNavigator est ensuite utilisé pour sélectionner le nœud auquel le contrôle Zone de texte est lié. Après quoi, il définit et place un deuxième objet XPathNavigator pour le contrôle Zone de texte au niveau de ce nœud. Enfin, la méthode SetValue de l'objet XPathNavigator est appelée pour affecter la valeur « Hello World! » au contrôle Zone de texte.

public void MyButton_Clicked(object sender, ClickedEventArgs e)
{
   XPathNavigator root, txtbox;
   root = this.MainDataSource.CreateNavigator();
   txtbox = root.SelectSingleNode("/my:myFields/my:field1", 
      this.NamespaceManager);
   txtbox.SetValue("Hello World!");
}

Public Sub MyButton_Clicked(ByVal sender As Object, _
   ByVal e As ClickedEventArgs)
   Dim root, txtbox As XPathNavigator
   root = Me.MainDataSource.CreateNavigator
   txtbox = root.SelectSingleNode("/my:myFields/my:field1", _
      Me.NamespaceManager)
   txtbox.SetValue("Hello World!")
End Sub

Voir aussi

Référence

ButtonEvent, classe
Membres ButtonEvent
Microsoft.Office.InfoPath, espace de noms

Partager via