Evento ButtonEvent.Clicked
Ocurre cuando se hace clic en un control Botón en una vista de un formulario.
Espacio de nombres: Microsoft.Office.InfoPath
Ensamblado: Microsoft.Office.InfoPath (en Microsoft.Office.InfoPath.dll)
Sintaxis
'Declaración
Public MustOverride Event Clicked As ClickedEventHandler
'Uso
Dim instance As ButtonEvent
Dim handler As ClickedEventHandler
AddHandler instance.Clicked, handler
public abstract event ClickedEventHandler Clicked
Excepciones
| Excepción | Condición |
|---|---|
| InvalidOperationException | El evento no se puede enlazar en una ubicación que no sea el método InternalStartup. |
| InvalidOperationException | Sólo se puede agregar un delegado al evento. Esta excepción se produce si se agregan varios delegados al mismo id. de control. |
Comentarios
El controlador de eventos de este evento no permite la cancelación del evento.
Nota
El evento Clicked desencadenado por el control Botón es el único evento admitido directamente por un control de un formulario. Con todo, la clase XmlEvent implementa eventos que se desencadenan cuando se realizan cambios en el documento XML subyacente del formulario. Con estos eventos, puede crear controladores de eventos que respondan a los cambios realizados desde controles enlazados a nodos y grupos del documento XML subyacente de un formulario.
Ejemplos
En el siguiente ejemplo, se supone que dispone de un control Botón y un control Cuadro de texto enlazado a field1 en el formulario. Al hacer clic en el Botón se abre un situado en la raíz del origen de datos principal del formulario (el documento XML subyacente).XPathNavigator se usa a continuación para seleccionar el nodo al que está enlazado el Cuadro de texto. Después, establece y sitúa un segundo XPathNavigator para el Cuadro de texto de ese nodo. Por último, se usa el método SetValue de XPathNavigator para establecer el valor del Cuadro de texto en "Hello World!".
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