Show App Button Properties

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.

Show App 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, app to be shown, relationship, custom parameters, positioning, tabbing, tool-tip and accessibility.

Show App 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 App Settings
[App Selected]	Click the Select button to display the Select an App dialog. Here you can choose from any of your published private or shared apps to determine which app will be launched when the button is clicked. Once the app is selected, the app name will display in the read-only field to the left of the Select button on the Properties panel.
App Instance
New Instance	Creates a new app instance but does not create a relationship between the two app instances.
Existing Instance	You need to specify which app field contains the instance ID to display. This option requires that the related (child) instance ID is being stored somewhere inside your app instance (e.g. in a helper field that is not visible to the user). The existing instance ID can also be supplied using the Connect or Connect and Search commands so you can build these relationships dynamically.
New Child Instance	Launches a brand new child app instance. The parent instance ID will be set in the newly created child instance.Once the child instance has been created, the child instance id will be stored as a property of the parent app instance. Subsequent presses of the button will launch a brand now child app instance.	Creating and Managing Child Instances
Single Child Instance	Creates a new child instance just once. Once this child instance has been created, the child instance ID is stored as a property of the button. Subsequent presses of the button will re-open that same child instance.	Creating and Managing Child Instances
Existing Child Instance	Displays a list of all existing child instances of the current instance ID. The user can then choose an existing child instance to open.	Finding and Viewing Related Apps Instances
Parent Instance	Opens the parent instance for the current app instance ID.	Finding and Viewing Related Apps Instances
Open in a 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
Custom Parameters
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 an app 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
	Click the Add button to add a custom parameter to the list.
	Click the Remove button to remove a custom parameter from the list.
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.

PerfectApps ® Help Guide