Configuration options for the Text control
Learn about the text control configuration options that you can use to customize the control. For example, you can select the format of the data that is displayed, specify visibility of the control, assign an ID for the testing purposes, and fine-tune the styling of the control.
General
| Field | Description |
| Property | Specifies a property or a parameter to source the data for the
control by using the following notations:
If the property that uses the Table Type field provides a set of possible values, specify a Single Value mode property that has a Table Type other than None. |
| Label | Sets the name of the property as the label for the control. You can enter your custom text by clearing the check box. |
| Label value | Specifies a custom label for the control. |
| Visibility | Determines when to display the control:
To include the section with the text control in the navigation of a portal, you can make the header visible only when a specific space is the current space, by entering an expression in the field. For example: pyCurrentSpace=="ASpaceName" |
| Reserve space when hidden | Adds a blank area which appears in the section when the text is hidden. |
| Run visibility condition on client | Activates dynamic evaluation of the condition each time the value of a property in the condition changes. |
| Value | Specifies the value that the control displays:
|
| Wrap text | Presents the label as multiple lines when the text is longer than the cell width. If this check box is not selected, the label might appear truncated at run time. |
Identifiers
| Field | Description |
| Tour ID | Specifies a unique string that identifies the element as a stop during the creation of a guided tour. You can use numbers, letters, and underscores. |
| Test ID | Specifies a unique string that identifies the UI element during
automated testing. You can either generate an ID or enter a value
that can include numbers, letters, and underscores. You can view the test ID in HTML or at run time in the Live UI info panel. The test ID is available to access groups that include the PegaRULES:TestID privilege. To disable test ID, remove the PegaRULES:TestID privilege from the access group. |
Presentation
| Field | Description |
| Control format | Determines the format of the control. |
| Label format | Determines the format of the label. |
Format
| Field | Description |
| Type | Read-only. Specifies the way in which the data is displayed. Your
selection determines other available format options. The following choices are available:
|
| Text alignment | Specifies left, right, or center alignment. |
| Decimal places | Controls the number of digits after the decimal place. The default is Auto,, which displays a maximum of three decimal places (placeholder zeroes are not added). You can select 0 to remove all digits after the decimal point and round to the nearest integer or All to include all digits. |
| Scale | Determines a label that specifies the scaling applied to the
number. The following scales are available:
For example, if you select Thousands, a value of 20,000 appears as 20 K. |
| Negative format | Specifies the format 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. |
| Symbol | Available only when you set the Type
option to Number. When a symbol is specified,
the value is prepended an additional character. You can use this option to select the way of representing the number:
|
| Separators | Specifies a separator for values of thousands. Depending upon the default locale, a comma or period is used. |
| Obfuscated | Hides user input by displaying graphic symbols. The input characters are initially added to the clipboard as unencrypted, clear text values. The system computes the hashed value only when the page is committed to the PegaRULES database. Then, the hashed value appears in both the clipboard and the database row. |
| Auto prepend | Adds a property, a parameter, a field value with or without parameters, or a constant before the property value. For example, when the user name appears, the system automatically adds the user title. |
| Auto append | Adds a property, a parameter, a field value with or without parameters, or a constant after the property value. For example, when the user name appears, the system can automatically add the full mail extension to the name. |
| Show value as | Labels the outcome of a boolean with text or an image. |
Advanced presentation options
| Field | Description |
| Cell read-write classes | Adjusts 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 default right margin for the element. You can click the Open helper class picker icon to specify one or more CSS helper classes to apply to this cell when the form is displayed in the read-write mode. You can enter several helper classes, and separate them by a space. Alternatively, you can enter the name of a custom style to apply to this cell. You can also enter a property or a parameter. |
| Cell read-only classes | Adjusts 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. You can click the Open helper class picker icon to specify one or more CSS helper classes to apply to this cell when the form is displayed in the read-only mode. You can enter several helper classes, separated by a space. Alternatively, you can enter the name of a custom style to apply to this cell. You can also enter a property or parameter. |
| Inline style (not for production use) | Defines an inline style that you can specify by entering CSS code. |
Previous topic Adding a Text control Next topic Configuring a text label in a layout cell or header