Freigeben über


ButtonEvent.Clicked Ereignis

Definition

Tritt ein, wenn Sie in einem Formular innerhalb einer Ansicht auf das Steuerelement Schaltfläche klicken.

public:
 abstract event Microsoft::Office::InfoPath::ClickedEventHandler ^ Clicked;
public abstract event Microsoft.Office.InfoPath.ClickedEventHandler Clicked;
member this.Clicked : Microsoft.Office.InfoPath.ClickedEventHandler 
Public MustOverride Custom Event Clicked As ClickedEventHandler 

Ereignistyp

Ausnahmen

Sie können dem Ereignis nur einen Delegaten hinzufügen. Diese Ausnahme wird ausgelöst, wenn mehrere Delegaten derselben Steuerelement-ID hinzugefügt werden.

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 verwendet, um den Knoten auszuwählen, an den das Textfeld gebunden ist. Anschließend wird ein zweiter XPathNavigator für das Textfeld auf diesem Knoten festgelegt und positioniert. Schließlich wird die SetValue(String) -Methode von XPathNavigator verwendet, um das Textfeld auf "Hallo Welt!" festzulegen.

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

Hinweise

Der Ereignishandler dieses Ereignisses lässt das Abbrechen des Ereignisses nicht zu.

Hinweis: Das clicked-Ereignis , das vom Button-Steuerelement ausgelöst wird, ist das einzige Ereignis, das direkt von einem Steuerelement in einem Formular unterstützt wird. Die -Klasse implementiert jedoch Ereignisse, XmlEvent die ausgelöst werden, wenn Änderungen am zugrunde liegenden XML-Dokument des Formulars vorgenommen werden. 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.

Gilt für: