ButtonEvent.Clicked-Ereignis
Tritt ein, wenn Sie in einem Formular innerhalb einer Ansicht auf das Steuerelement Schaltfläche klicken.
Namespace: Microsoft.Office.InfoPath
Assembly: Microsoft.Office.InfoPath (in Microsoft.Office.InfoPath.dll)
Syntax
'Declaration
Public MustOverride Event Clicked As ClickedEventHandler
'Usage
Dim instance As ButtonEvent
Dim handler As ClickedEventHandler
AddHandler instance.Clicked, handler
public abstract event ClickedEventHandler Clicked
Ausnahmen
| Ausnahme | Bedingung |
|---|---|
| InvalidOperationException | Das Ereignis kann nicht an einem anderen Speicherort als die InternalStartup-Methode gebunden werden. |
| InvalidOperationException | Sie können dem Ereignis nur einen Delegaten hinzufügen. Diese Ausnahme wird ausgelöst, wenn mehrere Delegaten derselben Steuerelement-ID hinzugefügt werden. |
Hinweise
Der Ereignishandler dieses Ereignisses lässt das Abbrechen des Ereignisses nicht zu.
Hinweis
Das vom Steuerelement Schaltfläche ausgelöste Clicked-Ereignis ist das einzige Ereignis, welches von einem Steuerelement eines Formulars direkt unterstützt wird. Die XmlEvent-Klasse implementiert jedoch Ereignisse, die beim Ändern des dem Formular zugrunde liegenden XML-Dokuments ausgelöst wurden. Mithilfe dieser Ereignisse können Sie Ereignishandler erstellen, die auf Änderungen antworten, die von Steuerelementen mit Bindung an Knoten und Gruppen im einem Formular zugrunde liegenden XML-Dokument vorgenommen wurden.
Beispiele
Im folgenden Beispiel wird davon ausgegangen, dass im Formular das Steuerelement Schaltfläche und ein an field1 gebundenes Steuerelement Textfeld vorhanden sind. Durch Klicken auf die Schaltfläche wird ein XPathNavigator-Objekt geöffnet, das am Hauptdatenquellen-Stamm des Formulars (im zugrunde liegenden XML-Dokument) positioniert ist. Dieser XPathNavigator wird dann zum Festlegen des Knotens verwendet, an den das Textfeld gebunden ist. Dann wird ein zweiter XPathNavigator für das Textfeld an diesem Knoten festgelegt und positioniert. Zum Abschluss wird mithilfe der SetValue-Methode von XPathNavigator das Textfeld auf "Hello World!" festgelegt.
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