Configure header/footer toolbar buttons

Define a header/footer toolbar for a form and add buttons to the toolbar.

Note You can configure standard properties of a button for each header/footer toolbar button, and also define an image button.

  1. In the properties panel, click under Toolbar buttons.
    The Advance properties dialog box is displayed.
  2. Use the following tabs to configure the properties of a toolbar button.
  3. General
    Name Description
    Type

    The type of the toolbar button.

    Enabled

    If selected, enables the button at runtime..

    Name

    A unique name for the button.

    Alignment

    Set alignment to Right or Left.

    Text

    Meaningful text that appears at runtime.

    Tooltip

    The supplementary information that displays on hovering the mouse over the button at runtime.

    Visible

    Makes the button visible at runtime.

    Security tokens

    Makes the button secure. See Security tokens.

    Resize to fit

    If selected, allows the image to be resized to fit the button frame. Otherwise, uses the original size.

    Load image from store

    When selected (default), allows you to select an image in the Image path field.

    If clear, allows you to enter an image name in the Image path field.

    Note For on-premise TotalAgility, the image needs to reside in the following location: <Installation location>\Kofax\TotalAgility\Agility.Server.Web\Forms\Images

    Causes validation

    Indicates whether the button causes validation to be performed on any controls that require validation. (Default: Selected)

    Note If an error occurs while validating the controls, then the button does not fire its event.

    Confirmation message

    A confirmation message to display when the button is clicked.

    A confirmation message can prevent the user from accidentally performing an action that may result in data loss.

    For example, when the user clicks 'Delete customer' button by mistake, it could delete the customer and all associated data from the system without having a chance to undo the action. But you can prevent that mistake by setting the following confirmation message on clicking the button: "Are you sure you want to delete the customer account details? Click Cancel to stop the deletion. Click Yes to confirm the deletion."

    Specify the message using a dynamic or a static value.

  4. Click Save.

    At runtime (header):

    • The toolbar appears docked at the top of the form.
    • The title text appears in the center.
    • The buttons are aligned to the right or left of the form, based on the configuration.

    At runtime (footer):

    • The toolbar is docked at the bottom of the form.
    • The buttons are aligned to the right or left of the form, based on the configuration.
    • If the content of the form is greater, a scroll bar appears but the footer is visible at the bottom.