Back Forward About the Text Area control

About Section rules

  Show all 

This topic describes the V5.1x Text Area control, which used the non-auto-generated control rule TextArea. As of V6.1 SP2, the control uses the auto-generated pxTextArea control rule. See Harness, Section, and Flow Action forms — Adding a Text Area control.

  Cell properties panel — Top fields

Click the magnifying glass icon (Magnifying glass) to open the Cell Properties panel. Complete the top fields that appear.GRP-229

If the panel is pinned (Pinned), the wireframe presentation on the rule form changes immediately to reflect of your inputs. If the panel is not pinned (not pinned), click Apply to apply your inputs.

Field

Description

Pencil

(Appears only when this field is in a section included within the current open rule.) Click to open the section that immediately contains the field.

Property

SmartPromptSelect or type a property reference that identifies a single text value. SR-4597 B-22011 Single Value only? (If you are only prototyping a form and the property you want to reference is not yet defined, use the template property .pyTemplateTextArea.)

Alternatively, you can drag a property name from the lists of properties visible in the Application Explorer. Typically, this works for Single Value properties belonging to in the Applies to class of the current rule (or a higher class). If the container in which this field sits has a non-blank Using Page value, you can drag a Single Value property from within that embedded page property. B-16325 Rejected

Click the pencil icon (Pencil) to review the property rule (if the reference is to an existing property in the Applies To class of this rule or a parent of that class). If the property is not found, the New dialog box for the property form appears.

You can reference properties on any page identified on the Pages & Classes tab, using the normal notation pagename.propertyname for pages other than the page corresponding to the Applies To class of the rule.

If this field is in a cell of a section that includes parameter declarations on the Parameters tab, you can enter the notation param.NAME here, to use a parameter value for the field, where NAME identifies a string parameter. Make sure that the NAME parameter is declared on the Parameters tab, and that your application provides a non-blank value for the parameter value in all possible situations where the section appears. See Section rules — Completing the Parameter tab. Proj-1424

Control

Autocomplete To present the field as a multiline textarea, use the standard control rule TextArea. Click the magnifying glass icon (magnifying glass) to supply parameters for this rule:

Parameter

Description

Rows Enter a positive integer to control the number of lines in the textarea.
Columns Enter a positive integer to control the width of each line in characters.
ExpandOptions Select:
  • ExpandedWithIcon   — The text area is initially presented in expanded mode at a size determined by the Rows and Columns parameters. The user clicks the Collapse control (Collapsed) to collapse the text area.
  • CollapsedWithIcon — The text area is initially presented in display-only mode, with only a few characters visible. The user clicks the Expand control (Collapsed) to expand the area.
  • AutoExpanding — Expands to match the value. VAGUE
  • NoScrollBar — Expanded, no scrollbar.
ReadOnlySmartInfo Optional. Identify the Purpose key part of a section to present as a SmartInfo pop-up for this control when the field is read-only.
ReadWriteSmartInfo Optional. Optional. Identify Purpose key part of a section to present as a SmartInfo pop-up for this control when the field is read-only.
Width Enter a positive integer to control the width of the control in pixels.
Behavior

Optional. Leave blank if no dynamic form actions to other parts of the form are to occur based on user updates or values for this field. C-1990

To establish a dynamic form action, click the magnifying glass icon (Magnifying glass) to open the Client Event Editor in a new dialog window. Complete the Client Event Editor to select an event (OnBlur, OnChange, or OnClick) and the resulting form action. C-2526

Click the help icon ( Help) on the Client Event Editor for assistance. For general information on this capability, see Implementing dynamic form actions and the Client Event Editor.

Client event support is not available for harness, section, or flow action rules that use directives.

  Cell properties panel — General tab

Complete the General tab.

The General tab for a TextArea is identical to the General tab for a Text Input control. See About the Text Input control — General tab.

  Cell properties panel — Advanced tab

Complete the Advanced tab.

The Advanced tab for a TextArea is identical to the Advanced tab for a Text Input control. See About the Text Input control — Advanced tab.

About Section rulesAbout Section rules