Text area control - Presentation tab
A text area is an area in which the user types or pastes one or multiple lines of text, without formatting the text. You can complete the Presentation tab while adding a Text area control.
Field | Description | ||||||||||||||
Edit Options | Select an edit mode for this control. The edit mode of the control,
specified here, takes precedence over section and harness settings.
| ||||||||||||||
Read-only when | Appears only when you select Read Only in the
Edit Options field. Enter or select one of the following:
As a best practice, use the Condition Builder to edit this field. Click the Open condition builder icon to open the tool. | ||||||||||||||
Specify width | Select Auto if you want the layout to determine the width of the control area. This is the default. If you want to specify the width, select Custom and set the width in columns, pixels, or percent. | ||||||||||||||
Specify height | Select Auto if you want the layout to determine the height of the control area. This is the default. If you want to specify the height, you can select Size to Content, which means setting the minimum number of pixels or rows to display, or Custom to set the height in pixels or percent. | ||||||||||||||
Min/Max characters | Optional. Enter a value that determines the minimum and maximum number of characters that can be entered in the text input. You can designate either value as unlimited by leaving it blank. | ||||||||||||||
Tooltip | If you want to display a tooltip when the user hovers the mouse pointer over the text input, press the down arrow to select the property that you want to display as a tooltip or type a text string within quotations, for example, "Select to open an item" . | ||||||||||||||
Placeholder | Select None if you do not want to display placeholder text. Select Other if you want to display a hint or instructional text in the field. The text disappears when the user enters a value. If the user does not enter a value, the placeholder text reappears when the field loses focus. | ||||||||||||||
Style | Specifies the format of the text input. You can style text input controls and create additional formats in the skin rule. To select a custom format, press the down arrow and select Other. | ||||||||||||||
Advanced Options | |||||||||||||||
Type | Select a format (read-only) used with this property. Your selection
filters the format options.
|
or
Date Format
Number.
Select left, right, or center alignment.
Number.
A non-negative integer to control the number of digits presented
after the decimal place. The default is Auto,
which
displays a maximum of three decimal places (placeholder zeroes are
not added). Select to remove all digits after the decimal point and
round to the nearest integer. Select All
to include
all digits.
Number.
Select a label indicating the scaling you wish to apply to the
number. The scales are K for thousands, M for millions, B for
billions, and T for trillions. For instance, if you select
Thousands,
a value of 20,000 appears as "20 K."
If Percentage
, the value appears as a percentage
sign (.8 appears as "80%").
Number
. Select a format (minus sign or parenthesis) for displaying negative numbers.
You can also specify a CSS class if you select one of the
Style Ref
options. By default, the class name
is NegativeNumber
.
Number.
When a symbol is
specified an additional character(s) is prepended to the value. Currency
automatically uses the localized currency symbol, constant uses a
string, and reference uses a property value. Select an option for representing the number as
Currency
- Formats the number as a currency using the default locale.Constant
- A text string or character (for example, "%") ASCII character that you enter.Reference
- A property value.
Number.
Select to use a thousands' separator. Depending upon the default locale, a comma or period is used.
Appears if the Read-only format Type is Text.
Select Yes
if you want the characters entered by
the user to appear as a string of bullets. The input characters are
initially added to the clipboard as unencrypted, clear text values.
The system computes the hashed value only as the page is committed
to the PegaRULES database. Thereafter, the hashed value appears in
both the clipboard and the database row.
Text
and the control is not
obfuscated. Select a property or constant that you want to add either before the displayed property value. For example, when the user name appears, the system can automatically prepend the user's title.
Text
and the control is not
obfuscated. Select a property or constant that you want to add after the displayed property value. For example, when the user name appears, the system can automatically append the full mail extension to the name.
True/False
. Select to label either outcome using Text or an Image.
False Image
Appears if the Type is True/False
and Show Value As
Image is selected.
Select an image to label either outcome. Used with a boolean type.
False Text
Appears if the Type is True/False
and Show Value As
Text is selected.
Enter a text string to label either outcome. Used with a boolean type.
If the Localize? check box is selected on the section's HTML tab, a SmartPrompt Appears in the Constant field in the Parameters dialog. Select a field value rule if you plan to localize the text. If this text is to be localized, enter no more than 64 characters. A field value rule with pyCaption as the second key part and this text as the final key part is needed for each locale.
Previous topic Text area control - General tab Next topic Date time (calendar) control