ButtonEvent.Clicked - Événement
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
'Déclaration
Public MustOverride Event Clicked As ClickedEventHandler
'Utilisation
Dim instance As ButtonEvent
Dim handler As ClickedEventHandler
AddHandler instance.Clicked, handler
public abstract event ClickedEventHandler Clicked
Exceptions
| 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.
Notes
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.
Exemples
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