This topic has not yet been rated - Rate this topic

Button.OnClick Event

Office 2007

Occurs when a button control is clicked within a view in a Microsoft Office InfoPath 2007 form.

Version Information
Version Added: InfoPath 2003

Syntax

expression.OnClick(pEvent)

expression An expression that returns a Button object.

Parameters

Name	Required/Optional	Data Type	Description
pEvent	Required	DocActionEvent	An event object that is used during a Microsoft Office InfoPath 2007 button click event.

Return Value
nothing

Remarks

This event handler does not allow users to cancel an operation.

Note
The OnClick event for the InfoPath button control is the only control event that is supported.

Example

In the following example, the OnClick event handler is used to perform data validation on some of the fields contained in the New Customer view when a user clicks a button to switch to another view:

JScript

JScript
function btnSwitchContact::OnClick eventObj) { if (XDocument.View.Name == "New Customer") { if (XDocument.DOM.selectSingleNode ('/Customers/CustomerInfo/CustomerName').text == "" && XDocument.DOM.selectSingleNode ('/Customers/CustomerInfo/CustomerID').text == "") { XDocument.UI.Alert("The Customer Name and ID must " + "be filled in prior to switching the view."); return; } else if (XDocument.DOM.selectSingleNode ('/Customers/CustomerInfo/CustomerName').text == "") { XDocument.UI.Alert("The Customer Name must be filled " + "in prior to switching the view."); return; } else if (XDocument.DOM.selectSingleNode ('/Customers/CustomerInfo/CustomerID').text == "") { XDocument.UI.Alert("The Customer ID must be filled in " + "prior to switching the view."); return; } } XDocument.View.SwitchView('Contact Customer'); }

function btnSwitchContact::OnClick eventObj)
{
   if (XDocument.View.Name == "New Customer")
   {
      if (XDocument.DOM.selectSingleNode
         ('/Customers/CustomerInfo/CustomerName').text == ""
         && XDocument.DOM.selectSingleNode
         ('/Customers/CustomerInfo/CustomerID').text == "")
      {
         XDocument.UI.Alert("The Customer Name and ID must " +
            "be filled in prior to switching the view.");
         return;
      }
      else if (XDocument.DOM.selectSingleNode
         ('/Customers/CustomerInfo/CustomerName').text == "")
      {
         XDocument.UI.Alert("The Customer Name must be filled " +
            "in prior to switching the view.");
         return;
      }
      else if (XDocument.DOM.selectSingleNode
         ('/Customers/CustomerInfo/CustomerID').text == "")
      {
         XDocument.UI.Alert("The Customer ID must be filled in " +
            "prior to switching the view.");
         return;
      }
   }
   XDocument.View.SwitchView('Contact Customer');
}

Community Additions

ADD