ButtonEvent.Clicked-Ereignis

Artikel
04/27/2010

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

Public Event Clicked As ClickedEventHandler

Dim instance As ButtonEvent
Dim handler As ClickedEventHandler

AddHandler instance.Clicked, handler

public abstract event ClickedEventHandler Clicked

Ausnahmen

Ausnahmetyp	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.

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.

Beispiel

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

Siehe auch

Referenz

ButtonEvent-Klasse
ButtonEvent-Member
Microsoft.Office.InfoPath-Namespace

Freigeben über