Welcome > Form Designer module > Add actions to a form or control > Add actions > Add a Set Focus action

Add a Set Focus action

In a form with several controls, the focus typically moves from one control to the next in a sequential manner. Use the Set Focus action to set the focus to directly shift on a specific control.

Example

In a Credit Check form for a loan applicant, two sections of details are submitted to evaluate credit worthiness of the applicant:

  1. Personal details such as Name, Surname, Date of Birth, and Age
  2. Income details such as Monthly income, Monthly Expenses, and Repayment Record (on other loans)

The Submit button is configured with two actions:

  • DB Query to add the applicant's personal details to the database as a record

  • Set Focus to shift focus to the Income field

Once the personal details of the applicant are submitted, the focus automatically shifts to the Monthly Income field in the Other Details section.

The Set Focus action can only be configured for the following controls:

  • Text box

  • Drop-down

  • Calendar

  • Radio button

  • Check box

  • Table

  • Button

    Note This control is only available for Desktop forms.

  1. On the Form Modeling bar, click Actions.
  2. On the Actions page, click Add Generic Add.
  3. On the Type list, select Set Focus.
  4. Enter a Name and Description for the action.
  5. Optionally, configure a unique action for each language separately. See Configure multilingual actions for a form or control for more information.
  6. In the Field box, consume the field on which to set the focus.
    Note Focus can only be set to one field.
  7. Click OK.

    The newly created action is added to the table.

  8. Click Save.
  9. Associate the action with the control to trigger this action. To call the Set Focus action upon form load, associate the action with the form. See Associate an action with a form or control for more information.

    When this action is triggered, the focus is shown on the configured field.