ButtonEvent.Clicked Evento

Definição

Namespace:

Microsoft.Office.InfoPath

Assembly:

Microsoft.Office.InfoPath.dll

Ocorre quando um controle Button é clicado em uma exibição em um formulário.

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 

Tipo de evento

ClickedEventHandler

Exceções

InvalidOperationException

Somente um delegado pode ser adicionado ao evento. Essa exceção será gerada se vários delegados forem adicionados para a mesma ID de controle.

Exemplos

O exemplo a seguir pressupõe que você tenha um controle Button e um controle text box que está vinculado ao field1 em seu formulário. Clicar no Botão abre um objeto XPathNavigator posicionado na raiz do main fonte de dados do formulário (o documento XML subjacente). Esse XPathNavigator é usado para selecionar o nó ao qual a Caixa de Texto está vinculada. Em seguida, ele define e posiciona um segundo XPathNavigator para a Caixa de Texto nesse nó. Por fim, o SetValue(String) método do XPathNavigator é usado para definir a Caixa de Texto como "Olá, Mundo!".

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

Comentários

O manipulador de eventos para este evento não permite o cancelamento do evento.

Observação: o evento Clicked gerado pelo controle Botão é o único evento com suporte diretamente por um controle em um formulário. No entanto, a XmlEvent classe implementa eventos que são gerados quando são feitas alterações no documento XML subjacente do formulário. Com esses eventos, você pode criar manipuladores de eventos que respondem a alterações feitas de controles associados a nós e grupos no documento XML subjacente de um formulário.