List Properties

Previous  Home topic  Next  Print this topic Send Feedback

Jump to a Section

Main

Style

Navigation

Behavior

 

 

 

Main Section

The Main section contains the name, label and more.

Name

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.

 

 

Items

Caption

Click in the Caption column and enter the list item. Repeat in each row for all the list items needed.

 

Each option in the list presented to the user will have a caption. The caption is the user-friendly representation of the data value equivalent for that selection.

 

The options presented in a list can be dynamic and based on a background look-up to another form or database. See Setting Up a Background Lookup Using a Connect Command.

Value

Enter a text or numeric value to be returned when the list item is selected and submitted.

 

Click in the Value column and enter the data value to be associated with that list option. The value can match the caption text if desired. Repeat in each row for all the list items needed.

 

 

Add Item Button

Click this Add Item button to add a row to the items list.

 

Remove Item Button

Click this Remove Item button to remove a row from the items list.

 

 

Move Item Up & Down

Click these Move Item Up and Move Item Down buttons to move options up and down in the items list.

 

 

Add Predefined List

Click the Add Predefined List button to supply a predefined list that will automatically populate the list object. Examples of predefined lists include States, Countries, Canadian Provinces or any list of resources that have been set up on the account.

 

Adding a List as an Account Resource

 

The options presented in a list object can be dynamic and based on a background look-up to another form or database. See Setting Up a Background Lookup Using a Connect Command.

 

Allow Multiple Selection

Select this check box to allow multiple selections within your list object. Form users will be able to select more than one option at once by pressing CTRL + Shift and choosing the desired options from the list.

 

 

State

State

Choose from Default, Normal, Read-Only, Disabled or Hidden for list 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

 

Ellipses Button

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.

 

Loading the Object States Overview

Mandatory Answer

 

Mandatory Answer Properties

Select the Mandatory Answer check box to make the object required in order to submit the form instance.

 

You may enter a custom message in the text input below the check box. This message will be displayed if some part of the object has not been completed prior to form submission.

 

Click the ellipses button to display the Edit Mandatory dialog. Use this matrix to make the object mandatory based on conditions of roles and stages.

Loading the Object States Overview

Marking as Mandatory

Checking for Mandatory Fields

Mandatory Field Checking and Field States Example

 

 

Style Section

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

Items

Font Name

Select the font face for the list item text.

 

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.

 

 

Font Options

Choose the size and style of the font for the list item text.

 

 

Color Picker

Enter a Hex color code or click on the color box to pick a color for the text of the list items.

 

 

Border

Border Appearance Type

Select the border appearance type. Choose from None or Solid.

 

 

Size

Choose a line weight for the border (in pixels).

 

Color Picker

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

 

 

Radius

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

 

 

Background

Color Picker

Enter a Hex color code or click on the color box to pick a background color for the list object.

 

 

Theme

Reset Button

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

 

Applying or Resetting a Theme

 

 

Navigation Section

The Navigation section provides properties related to positioning of the object and tab order.

Position

Top

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

 

Aligning, Spacing and Layering Objects

Left

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

 

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 their mouse over the object.

 

 

 

 

Behavior Section

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

List Changes Field Data

This event occurs when a form user changes data in the list object.  

 

How Behaviors Are Triggered

Setting Up a Background Lookup Using a Connect Command

 

 

List Gains Focus

This event occurs when the list object becomes the active field.  

 

How Behaviors Are Triggered

Setting Up a Background Lookup Using a Connect Command

 

List Loses Focus

This event occurs when the list object is exited.  

 

How Behaviors Are Triggered

Setting Up a Background Lookup Using a Connect Command

 

List is Clicked

This event occurs when a form user clicks on the list object.  

 


Note: This event is different than List Gains Focus in that the form user must mouse-click on the object in order for the event to occur and any linked behavior commands to run.


How Behaviors Are Triggered

Setting Up a Background Lookup Using a Connect Command

 

 

List is Shown

This event occurs when the list object is shown.  

 

How Behaviors Are Triggered

Setting Up a Background Lookup Using a Connect Command

 

Updated: 03/02/2012  Page url: http://www.perfectforms.com/Documentation/manual/html/?fl_list_properties_reference.htm
PerfectForms™ -- forms software, workflow software, and business process management