Text input control - Presentation tab
A cell in a layout can present the value of a property, as display-only or as an input field. When you add a Text input control, you can complete the Presentation tab.
Field | Description | ||||||||||||
Edit Options | Select an edit mode for this control. The edit mode of the control
takes precedence over section and harness settings.
| ||||||||||||
Read-only value | 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 Size | Specifies the width of the text input. Select Auto if you want the layout to determine the width of the control area. This is the default. If you want to specify a fixed width for the text input, select Custom and then specify the width in pixels or percentage. | ||||||||||||
Min/Max Chars | 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. | ||||||||||||
Control format | Optional. Specifies the style format applied to the control. You can define multiple formats in the skin rule. Press the down arrow to select another format, if applicable. | ||||||||||||
Label format | Read-only option. Specifies the format of the control's label. | ||||||||||||
Editable Format | |||||||||||||
Type | Select a type (editable) used with this property. Your selection
filters the format options.
|
Select a format (read-only) used with this property. Your selection
filters the format options.
Group/Selection | Description |
None | The property is not formatted. There are no options. |
Date | Renders DateTime and
Text property types in date-only
format (hours and minutes are not displayed). See
Understanding the Date, Time of Day, and DateTime
property types.Specify the format in the Date Format field. |
Date/Time | Renders DateTime and
Text property types in date and
time format. See Understanding the Date, Time of Day, and DateTime
property types.Specify the format in the DateTime Format field. |
Email | Renders the email address as a link. When the link is clicked, the email composer opens with this value populated in the To: field. |
Number | Numeric properties on output. |
Phone | Renders the phone number as a link. When the link is clicked, the phone dialer or another configured phone application opens. |
Text | Unedited text, which may contain spaces, tabs, line break characters, and other control characters. |
True/False | Boolean values. Specify the format in the True Label and False Label fields. |
URL | Opens the URL as a link in new window. |
or
Date Format
Date/Time
or
Date
.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.
To enable native browser support, check the Use native control on mobile.
The native control option only appears for the Date Time control types.
To enable read-only formatting, check the Display value using read-only formatting check box. The read-only formatting option only appears for the Currency, Date Time, Integer, Number and Percentage control types when the Editable Format is Number.
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.
- Default - The default value per the prconfig xml
- Round towards positive infinity
- Round towards zero
- Round towards negative infinity
- Round down to nearest - round to the nearest neighbor, where an equidistant value is rounded down
- Round to nearest even number - round to the nearest neighbor, where an equidistant value is rounded to an even value
- Round up to nearest - round to the nearest neighbor, where an equidistant value is rounded up
- Round away from zero
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 input control - General tab Next topic Adding a Text area control