Table Text Area Properties

The Attributes section includes the object name.

Name	Enter a name for the column.

We strongly recommend that each column is given a suitable and unique name. The object name will, very likely, be referred to when adding behavior.

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

Text Area changes field data

This event occurs when an app user enters data into the text area input object and the object is exited.

Key is pressed

This event occurs when an app user enters data into the text area input object. Note that the data is not stored in the object until the object has been exited.

Enter key is pressed

This event occurs when the user's cursor, or focus, is in the text area input object and the enter key is pressed.

Text Area gains focus

This event occurs when the text area object becomes the active field.

Text Area loses focus

This event occurs when the text area input object is exited.

This event is different than text area changes field data in that the event is triggered even when no data has been entered or modified.

Text Area is clicked

This event occurs when an app user clicks on the text area input object.

This event is different than text area gains focus in that the app user must mouse-click on the object in order for the event to occur and any linked behavior commands to run. Tabbing into the object will not trigger this event.

The settings section includes the option to set the column header and width, pre-select the date and mandatory answers.

Text Area Settings
Object	Details	Additional Information
Header	Enter the text to be displayed in the text area column header
Width	Edit the width (in pixels) of the object presented in this column.
Alignment	Choose the alignment of the text within the object: left, center, or right.	The default setting for a Text Area object is left.
[default text]	Enter a default value for the object (optional).
Max Chars	Enter the maximum number of characters for the text area. The object will default to a value of 400, the maximum is 99,999
Format	Choose from several formatting options. If the app user does not enter a value in the format specified, the object is displayed in red	If the column is mandatory they must use a correct format before submission. If the column is not mandatory they may also clear the field before submission.
Autocomplete
	Checking this box enables the autocomplete feature	Data in the field can be completed automatically from pre-defined lists and connections (Databases, Directory Services, REST and SOAP APIs, Google Services and text Files.)
	Select the minimum number of characters to activate the autocomplete function.	The minimum number of characters is 3.
	Choose the type of data-source for the autocomplete function. The options are Connection or List.	Further configurable fields will be displayed depending on the chosen option.
Autocomplete - List
	Choose from pre-defined lists configured in the account. See: Adding a List as an Account Resource	Only the caption from the list is returned. Use the refresh button if a new list is added and not seen in the drop-down list.
Autocomplete - Connection
	Choose from connections configured in the account. See: Creating Connections	Only connections that have at least one Select Action will be available to choose from. Use the refresh button if a new connection is added and not seen in the drop-down list.
	Choose from Select Actions configured in the selected connection. See: Defining Connection Actions	Only Select Actions will be available to choose. Use the refresh button if a new action is added and not seen in the drop-down list.
	Select the source of the data from the action.	Action return parameters will be displayed on the Source drop-down. Only one return parameter may be chosen.
	The send parameters will be displayed in a table and can be configured like in a standard connection; they can have values from a field or a formula.
Mandatory
Mandatory Answer	Select the Mandatory Answer check box to make the contents of the object required in order to submit the app 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 app 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.	Marking as Mandatory Checking for Mandatory Fields

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 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 of the font for the text.
	Enter a Hex color code or click on the color box to pick a color for the text.
	Choose the style of the font for the text.
Background
	Enter a Hex color code or click on the color box to pick a background color for the object.

The Access section contains properties for field state management.

State
Object	Details	Additional Information
	Choose from Default, Normal, Read-Only, Disabled or Hidden for Text Area 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