HomeUsing LincDoc 3.1+ActionsUsing Button Actions

11.4. Using Button Actions

You can associate an action with a specific buttons on your form. These button can be form-level buttons or field-level buttons.

Form-level buttons are associated with form itself, and are defined on the Actions tab of the Admin interface (for example, the Submit button).

Field-level buttons are associated with specific fields within the form, and are defined by accessing the field's Actions and Buttons dialog box.

Proceed to one of the following topics for more information:

Accessing the Buttons List

The Buttons list allows you define buttons for both form-level and field-level buttons. However, the method used to access the list varies based on the type of buttons used.

Accessing the Form-level Buttons List

To access the Buttons list for a Form-level button, simply click the Actions tab on the Admin interface.
 

Accessing the Field-level Buttons List

To access the Buttons list for a field-level button, you need to locate the field that will use the button, and then field's Actions and Buttons dialog box.

  1. On the Admin interface, verify that the Fields/Sections tab is selected.

  2. In the Fields/sections list, click the field that will be associated with the button.
  3. In the Field attributes area, click the advanced check box.
  4. Locate the Actions and Buttons option, which can be found near the bottom of the Field attributes area.

  5. Click the corresponding arrow button .

    The Actions and Buttons dialog box appears, and the Buttons list is shown on the left side of the dialog box.

Adding a Button

Once you have accessed the buttons list, you may need to add a new button for the action to the list of existing buttons.

If you want to edit an existing button, see Editing a Button for more information.

  1. Verify that you have accessed the Buttons list as described in Accessing the Buttons List
  2. On the Buttons list's top level entry, click the arrow button , and click add button.
  3. A button named NEW with the condition of Always is created.
  4. Perform any of the following actions, as desired:

Editing a Button

Once a button has been added to your list, you can edit a button's label, set conditions for the button, and even apply an image to the button.

  1. Click the button's corresponding arrow button .
    Additional options appear.
  2. Select edit.
    The Edit button dialog box appears, showing the available button settings.
  3. Edit the following settings, as desired:
    Label. Specify the text that will appear on the button in the form. This setting also is used to identify the button in the Buttons list itself.
    - Show label. Allows you to control whether or not the defined label appears directly on the button in the form. If you wish to define a label only for the purposes of the Buttons list, and you do not what that label to appear on your form, clear (uncheck) this setting.
    - Stop on error. When selected, prevents the subsequent button actions from proceeding when an error is detected.
    - Allows you to control the button's visibility on your form. For more information on using conditions, see Configuring Conditions.
    Button image. Use the corresponding arrow button  to choose an image for the button. The image appears to the left of the button's label on your form. A preview of the button, with both its label and any selected image, appears to the left of the arrow button .
  4. Click save.
    You are returned to the Buttons list, and the button is updated 

Applying an Action to a Button

Once you have created and edited a button, you can apply an action to the button. This action will be executed when the corresponding button is clicked on your form.

For more information, see Applying an Action to a Button or Event.

Applying a Rule to a Button

Once you have created and edited a button, you can apply a rule to the button. This rule is then evaluated, and any associated actions executed, when the corresponding button is clicked on your form.

For more information on applying a rule, see Applying an Action to a Button or Event.

For more information on rules themselves, see About Rules.

Deleting a Button

You can delete a button from your form at any time.

  1. On the Buttons list, locate the button you want to delete.
  2. Click the button's corresponding arrow button .
    Additional options appear.
  3. Click delete.
    The button is removed from the Buttons list, and will not appear in your form.

This page was: Helpful | Not Helpful