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.
|Edit Options|| Select an edit mode for this control. The edit mode of the control
takes precedence over section and harness settings.
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. See Using the Condition Builder to configure dynamic UI actions.
|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.|
Select a type (editable) used with this property. Your selection filters the format options.
|Text Alignment||Select left, right, or center alignment.|
|Advanced Options||Instead of creating a new custom format in the skin, you can adjust elements in a cell by applying Cascading Style Sheet (CSS) helper classes. For example, you can use a CSS helper class to center an element in a cell or to double the standard right margin for the element.|
Select a format (read-only) used with this property. Your selection filters the format options.
| DateTime Format
|Appears if Type is
|Text Alignment|| Appears if Type is
Select left, right, or center alignment.
|Decimal Places|| Appears if Type is
A non-negative integer to control the number of digits presented
after the decimal place. The default is
|Use native control on mobile|| Enables the use of native rendering on mobile devices. At runtime,
the date and time pickers display using the mobile browsers native
calendar date and time pickers.
To enable native browser support, check the Use native control on mobile.
The native control option only appears for the Date Time control types.
|Display Read-only formatting|| At runtime, read-only formatting displays when the editable field is
not in focus. When the editable field is in focus, it behaves as normal
input. The actual value gets submitted although the formatted value is
displayed. Editable formatting does not appear when there are
client-side and server-side validations.
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.
|Scale|| Appears if Type is
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
|Negative Format|| Appears if the Type is
Select a format (minus sign or parenthesis) for displaying negative numbers.
You can also specify a CSS class if you select one of the
|Show validation messages in read-only mode||Select this option to display validation errors to users at run time. When enabled for auto-generated controls in read-only mode, if the control's validation fails, the validation message is displayed. This option is available on the Presentation tab under Read-only Format . It is also available in the control ruleform. When enabled on the control ruleform, all controls using that ruleform have the option enabled.|
|Symbol|| Appears if Type is
Select an option for representing the number as
|Rounding Method|| Specifies how halfway values are handled:
|Separators|| Appears if Type is
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.
|Auto Prepend|| Appears if Type is
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.
|Auto Append|| Appears if Type is
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.
|Show Value As|| Appears if the Type is
Select to label either outcome using Text or an Image.
| True Image
Appears if the Type is
Select an image to label either outcome. Used with a boolean type.
| True Text
Appears if the Type is
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.
- Adding a Text input control
A cell in a layout can present the value of a property, as display-only or as an input field. Follow these instructions to control the presentation of a property value in a Text input control.