Button Events

The Measurement Studio button control generates a variety of events in response to user input or changes in properties that are bound to a DataSocket source.

Complete the following steps to add an event handler for a particular event generated by the button control.

1. Edit a dialog resource and add a Measurement Studio button control to the dialog.

2. Right-click on the button control and select Events.

3. Select the appropriate event to handle and select Add and Edit. By default, this creates a new member function, which is named in the form shown below.

On[eventName][objectIdSuffix]

To help you find the appropriate online help, the components of the member function name are described below.

• eventName is the event name.
• objectIdSuffix is the last part of the ID assigned to the control.

For example, if you have a button control for which the ID is IDC_CWBUTTON1 and you want to add a handler for the Click event. The default member function name created by the ClassWizard is OnClickCwbutton1.

4. Click OK to add and edit the new event handler. Notice that the prototype of the member function matches the corresponding event listed below. You can select this link to get additional information regarding the event.

Note: Various button events pass COM VARIANT data types as parameters to the event handler. Measurement Studio includes the CNiVariant class, which provides a convenient interface for managing these VARIANT data types. Refer to the documentation for each event for further information.