Rich Text Editor control Properties — Presentation tab

Click the View properties icon in the layout containing the rich text editor control ( pxRichTextEditor ) to display the Properties panel and select 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.
  • Auto — the control uses the edit mode of the section or harness in which it appears. If the section is set to Read Only, then the control is Read Only. If the section is set to Auto, then the control uses the edit mode of the harness. For example, a New harness is editable, while a Review harness is read only.
  • Read Only (always) — the property value is presented in read-only mode always, even when the enclosing layout is in read-write mode.
  • Read Only (expression) — the property value is presented in read-only mode using a simple expression based on the comparison of a pair of constants, properties, or both, combined by Boolean operators, such as .Color="Red". You can combine the expression with a when condition rule or another expression using the && and || operators.

    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.

  • Read Only (when rule) — the property value is presented in read-only mode based on a when condition rule or client-side test, even when the enclosing layout is in read-write mode. Enter or select the When Name key part of a when condition rule. Click the Open icon to review or create the rule.
  • Editable — the control is editable, regardless of the edit mode of the enclosing layout.

Select the Show toolbar in Read Only mode check box to show the Rich Text Editor toolbar when Rich Text Editor is in read-only mode.

Specify width Specify how the control's width should be determined:

Auto — Resizes according to the dynamic layout's skin settings (minimum and maximum width).

Custom — Sets a fixed (pixels) or proportional (percentage) width for the runtime control.

Specify height Specify how the control's height should be determined:
  • Auto — Resizes according to the dynamic layout's skin settings (minimum and maximum width).
  • Size to Content — Height is determined to accommodate content.
  • Custom — Sets a fixed height (in pixels) for the runtime control.
Control format Read-only option. 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.

> Advanced Presentation 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.
  • Cell read-write classes – 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 read-write 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.
  • Cell read-only classes – 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 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.
  • Inline style (not for production use) – You can use this field to define an inline style by entering CSS code. However, entering an inline style results in a guardrail warning. For maintainability and reuse, the recommended approach is to use read-write or read-only classes.
For more information, see CSS helper classes.