PerfectApps ® Help Guide

The Attributes section includes the object name and caption.

Name

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

Caption

Enter the text that you want displayed on the button.

The Behavior section lists possible events on the object that can prompt a behavior to run.

Submit Button is Shown

This event occurs when the button is shown. This is often when the object's page is opened.

The settings section includes the button type, success message, after submission options, positioning, tabbing, tool-tip and accessibility.

Submit Button Settings

Object

Details

Additional Information

Button Type

Use this to control the appearance of the button. Button types include:

oPush Button

oRectangular Mouse Over Button

oRounded Mouse Over Button

Show Success Message

Select this check box to show the success message when the app is submitted.

[Success Message Text]

Enter the success message text that will be shown when the submission is successful.

Submit as Child Even if Parent is Not Submitted

Select this check box and, if the child is submitted, it will be written into the database immediately, even if the parent instance has not yet been submitted for the first time.

Submitting Parent and Child Instances

After Submission

Close

Closes the app instance after the app user clicks the Submit button.

Open New Instance

Loads a new, blank instance of the app after the app user clicks the Submit button.

Re-open Same Instance

Reloads the current app instance (known as an 'invisible submit' or save) after the app user clicks the Submit button.

Using a Submit Button Object as a Save Button

Close Browser Window

Closes the browser window (and app) after the app user clicks the Submit button.

Redirect to a URL

Loads a Web page after the app user clicks the Submit button. The URL may be static or dynamic based on the options selected in the Redirect to URL section below.

Special Fields

Using the Formula and Condition Editor

Position

Top

Displays the object's location in from the top of the app (in pixels).

Left

Displays the object's location in from the left margin of the app (in pixels).

Width

Shows the width of the object.

Height

Shows the height of the object.

The minimum height is determined by the font size and cannot be less than 10px.

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.

Tabbing

Tab Index

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

Tab Index

Tab Stop

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

Tooltip

Enter tooltip text to show to an app user when they hover their mouse over the object.

Accessibility

Same As Caption

App users accessing the app with the JAWS accessibility tool will be read the caption of the check box.

Accessibility and JAWS Compatibility

The Style section contains properties that control the font appearance and theme applied to the object.

Text

Object

Details

Additional Information

Select the font face for the caption text.

Fonts from the designers local machine will also be available provided the option to Use Custom Font has been selected in the Account Settings, 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 caption text.

Manually enter font sizes smaller than the minimum selectable in the drop-down.

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 an app 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 app user clicks it.

Choose the style of the font for the caption text.

Border

Color

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

Select a numeric value to represent the curvature of the object's corners. The higher the number, the more curved the the edges of the object 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 an app 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 an app 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.

Use App Theme

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

Applying or Resetting a Theme

The Access section contains properties for field state management.

State

Object

Details

Additional Information

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

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

Adding Workflow

The Workflow Diagram

Loading the Object States Overview

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 objects depending on the user's role and/or the workflow stage.