Name

Enter a name for the object. This is the name of the object as it will show in field chooser, the Browser bar and other object lists.

Caption

Caption

Enter the label text to be shown on the button object.

Report

Report and Select

Click the Select button to display the Select a Report dialog. Here you can choose from any of your private or shared reports to determine which report will be launched when the button is clicked. Once the report is selected, the report name will display in the read-only field to the left of the Select button on the Properties bar.

Custom Parameters

Add button

Click the Add button to add a custom parameter to the list.

Setting Up Custom Parameters

Remove button

Click the Remove button to remove a custom parameter from the list.

Name

Click in the cell to enter a name for the parameter.

Setting Up Custom Parameters

Source

Choose the source of the parameter to be passed. Options include a report field, object or a formula (if the Formula check box is checked). Note: Data passed cannot exceed 250 characters.

Setting Up Custom Parameters

Formula

Check this box to enable formula editing for the selected parameter. Then click in the Source column to launch the Formula and Conditions Editor.

Using the Formula and Condition Editor

Misc

New Window

Choose whether you want to display the other instance in the same window (the current instance will close without saving) or in a new browser window/tab.

Show Error Messages

Displays detailed messages to the user. This is usually a  required behavior. To handle the errors yourself, clear this check box and specify the error code and return code values in a subsequent branch command.

Simple Branch or Multiple Branch

State

State

Choose from Default, Normal, Disabled or Hidden for Show Report Button objects.

With field state management, you control access to individual objects on the form. You can prevent individual roles from changing, or even viewing, specific data or areas on the form. See Limiting User Access to Form Fields for more information on how to control access to fields.

Adding Workflow

The Workflow Diagram

Limiting User Access to Form Fields

Explanation of State Priority

Understanding the Default State

Click the ellipses button to display the Edit State dialog. Use this option to hide, show or disable buttons depending on the user's role and/or the workflow stage.

Select the font face for the button caption.

Fonts from the designers local machine will also be available, however if the same font is not installed on the users machine then a standard font will be used to display the data.

Choose the size and style of the font for the button caption.

Normal

Enter a Hex color code or click on the color box to pick a default color for the text on the button.

Over

Enter a Hex color code or click on the color box to pick a color for the text on the button to change to when a form user mouses over it.

Down

Enter a Hex color code or click on the color box to pick a color for the text on the button when the form user clicks it.

Border

Color

Enter a Hex color code or click on the color box to pick a border color for the button.

Corner Radius

Select a numeric value to represent the curvature of the button corners. The higher the number, the more curved the edges of the button will be.

Background

Normal

The Normal option lets you set the button's default background color(s).

There are two color pickers available for this, enabling you to add duo-tone color gradation. The first controls the color for the top half of the button and the second controls the color for the bottom half of the button. For either color picker, you may enter a Hex color code or click on the color box to select the desired color.

Over

The Over option lets you set the color(s) that will display for the button's background when a form user mouses over the button.

There are two color pickers available for this, enabling you to add duo-tone color gradation The first controls the color for the top half of the button and the second controls the color for the bottom half of the button. For either color picker, you may enter a Hex color code or click on the color box to select the desired color.

Down

The Down option lets you set the color(s) that will display for the button's background when a form user clicks the button.

There are two color pickers available for this, enabling you to add duo-tone color gradation The first controls the color for the top half of the button and the second controls the color for the bottom half of the button. For either color picker, you may enter a Hex color code or click on the color box to select the desired color.

Theme

Resets the appearance options to the default settings configured on the form's Theme properties.

Applying or Resetting a Theme

Top

Shows the number of pixels from the top of the form where the object will be located.

Aligning, Spacing and Layering Objects

Left

Shows the number of pixels from the left margin of the form where the object will be located.

Aligning, Spacing and Layering Objects

Width

Shows the width of the object.

Aligning, Spacing and Layering Objects

Height

Shows the height of the object.

Aligning, Spacing and Layering Objects

Layer

Indicates the layer number this object occupies. You can drag an object so that it fully or partially covers another object. Depending on the layer number it occupies, it may be positioned underneath another other object.

Aligning, Spacing and Layering Objects

Tabbing

Tab Index

Indicates the order in the tabbing sequence that this object will be arrived at when the form user is using their Tab key to navigate through the form fields.

Setting or Modifying Tab Stops and Tab Order

Tab Stop

Clear this check box to exclude the object from the tab order altogether.

Setting or Modifying Tab Stops and Tab Order

Tooltip

Enter tooltip text to show to a form user when they hover the mouse over the button object.

Accessibility

Same as Caption

Form users accessing the form with the JAWS accessibility tool will be read the caption of the button.

Accessibility and JAWS Compatibility

Show Report Button is Shown

Occurs when the Show Report button object is shown.  

How Behaviors Are Triggered