Table Properties

Previous  Home topic  Next  Print this topic Send Feedback

Jump to a Section

Main

Style

Navigation

Behavior

 

Related Topics

Doc Icon for Jump to Section Working with Tables

Doc Icon for Jump to Section Performing Row Calculations

Doc Icon for Jump to Section Performing Column Calculations

 

 

 

Main Section

The Main section contains the name, column detail, row detail 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.

 

 

Columns

Header

The value in this column represents the column name.

 


Note: The column name is a property of the column object. To edit the column name, access the Column Properties bar by double-clicking on the entry in the Header column of the Columns list.


 

Type

Select the type of column object.

 


Note: The Type selected here dictates what properties are available. To access the Column Properties bar, double-click on the entry in the Columns list.


 

Type options include:

 

Button - Show a button which, when clicked, can run a pre-defined behavior.
Check Box - A standard check box.
Child Form Button - See the Linking Forms and Using Parent-Child Relationships topics for a full explanation. In short, it causes a new instance of a user-specified form to be displayed. PerfectForms™ maintains the relationship between the button and the child form so if it is clicked again, it will show that same child form instance. Note that the Child Form column properties contains a property titled 'New Window' that instructs the form to open the child instance in a new browser tab.
Date input - Enables date selection from a drop-down calendar or by manual date entry.
Drop-Down - A drop-down list of optional values.
File Attachment - Allows the form user to attach a file within a table row.
Numeric Input - Allows for numeric entry only.
Radio Button - Acts only as a visual indicator of one item selected in a table. Unlike a regular Radio Button object, no specific value can be returned from the user's selection in a Radio Button Column.
Text Area - Provides a multi-line text input.
Text Input - Allows for text entry on a single line.
Time Input - Time input allowing a 24-hr clock as  well as other options.

Linking Forms and Using Parent-Child Relationships

State

The value in this column displays the state assigned to the column.

 

To edit the state, double-click the item and make changes in the State field on the column object's Properties bar.

 

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

Add Column Button and Type Selection

Click the Add Column button to add a new column to the table.

 

If you want to specify the column type prior to adding the new column, select an option from the drop-down list to the right of the Add Column button. Once you've made a selection, then click the Add Column button. The Properties bar reloads with the new column's properties open for editing. Only properties for that object type are displayed.

 

 

Move Item Up & Down

Click the Move Column Up and Move Column Down buttons to reorder the table columns by moving them up and down in the list.

 

Remove Item Button

Click the Remove Column button to remove a column from the table.

 

Fit Columns Evenly Button

Click the Fit Columns Evenly button to automatically make the widths of all of the columns the same.

 

 

 

Rows

Height

Edit the default height (in pixels) of the rows. Normally this should be left at its default setting. However, if you have a Text Area field, you may want to increase this value so you can see multiple lines at once.

 

 

Max

Specify the maximum number of lines of data that may be entered into the table.

 


Note: The maximum number of rows that can be included in a table is 400,000.


 

Misc

Show Header

Select or clear this check box to show or hide the header row for the table.

 

 

Height

Edit the height (in pixels) of the columns in the header row for the table.

 


Note: This value is not used if the 'Show Header' check box is cleared.


 

It is recommended that you use the default height value provided unless your header text is long and needs to wrap to fully display. It should be noted that the header text is actually entered on the column properties, not the table properties. See the Header property definition for additional information.

 

Show Buttons

Select or clear this check box to show or hide the row control buttons located beneath the table. These buttons allow the user to add or remove rows from the table.

 

 

Resizable Columns

Select this check box to allow form users to resize column widths.

 

 

State

State

The value in this field represents the state for the table object as a whole. Choose from Default, Normal, Read-Only, Disabled or Hidden for table 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.

Header

Font Name

Select the font face for the column header 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 column header text.

 

 

Color Picker

Enter a Hex color code or click on the color box to pick a color for the column header text.

 

 

Header Background

Header Background Color Pickers

Set the default background color(s) for the cells in the header row.

 

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 header cell and the second controls the color for the bottom half of the header cell. For either color picker, you may enter a Hex color code or click on the color box to select the desired color.

 

 

Rows Background

Rows Background Color Pickers

Set the default background color(s) for the alternating rows in the table.

 

The first color picker controls the first row in the table and every other row after that. The second color picker controls the second row in the table and every other row after that.

 

For either color picker, you may enter a Hex color code or click on the color box to select the desired color.

 

Border

Border Appearance Type

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

 

 

Size

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

 

 

Color Picker

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

 

 

Radius

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

 

 

Background

Background Color Picker

Enter a Hex color code or click on the color box to pick a background color for the Add and Remove button area located below the table grid.

 


Note: If the Show Buttons option in the Main section of the table properties is turned off, then this Background value will not apply as that section of the table will be hidden.


 

 

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.

 

 

Accessibility

Description

Enter text that will be read aloud or converted to Braille for JAWS users.

 

Accessibility and JAWS Compatibility

 

 

Behavior Section

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

Table Changes Field Data

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

 

How Behaviors Are Triggered

 

 

Row is Added

This event occurs when a form user adds a row to the table.

 

How Behaviors Are Triggered

Row is Deleted

This event occurs when a form user removes a row from the table.

 

How Behaviors Are Triggered

Row is Added or Deleted

This event occurs when a form user adds a row or deletes a row.

 

How Behaviors Are Triggered

Row Gains Focus

This event occurs when a row becomes the actively selected object.

 

How Behaviors Are Triggered

Row Loses Focus

This event occurs when a row is exited.

 

How Behaviors Are Triggered

Table Gains Focus

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

 

How Behaviors Are Triggered

 

Table Loses Focus

This event occurs when the table object is exited.  

 

How Behaviors Are Triggered

 

Table is Clicked

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

 


Note: This event is different than Table 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

 

 

Table is Shown

This event occurs when the table object is shown.

 

How Behaviors Are Triggered

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