Creating Widget Events

Use the Coding tab to assign widget events to a control.

1. Go to the Properties view of the control for which you are creating a widget event.
2. Click the Coding tab, and enter an optional base name for the event.
   The base name represents the selected item in the generated code, for example, "SubmitButton."

   Note:

   • The base name must begin with a letter or underscore.
   • The base name can consist of alphanumeric characters (a–z, A–Z, 0–9) and underscores only, and must also be a unique name within the screen.
   • The base name cannot be localized.
   • The base name for display or tab panels must be unique within the screen as well as unique within the application.
   • You can have a display or tab panel base name that is the same as a control base name on another screen, but it cannot be the same name as another display/tab panel.
3. Select the events to assign to the control individually, or click Select All.
4. From the main menu, select File > Save.
5. Use the Device Application Designer to generate the code for the device application.
6. The generated widget event code is saved in the Custom folder, where you can then customize it.

• Widget Event Support by Platform
  Widget event controls
• onLoad Event
  The onLoad widget event is called when a control or container is loaded.
• onClick Event
  The onClick event is called when the control is acted upon.
• onValueChange Event
  Use the onValueChange event when the value of an input control changes.
• onRecordChange Event
  The onRecordChange event is called when a user scrolls through records.
• onOrientationChange Event
  The onOrientationChange event is called when the orientation of the device changes.
• onDraw Event
  The onDraw event is called after the control or container is called to paint the object.