Rich Text Control

Description

The Rich Text control allows you display text formatted by Hypertext Markup Language (HTML) or Rich Text Format (RTF). This control can contain manually entered data, data that comes from a data source, or both.

Properties Common to Most Controls

For more information about the properties listed below, see Properties Common to Most Controls.

For more information regarding each of the property groups, see the Control Reference.

Actions

Can Grow

Type: Boolean

Sets whether the control's height can grow to display the contents at runtime.

Enabled by default.

If there are other controls below the selected control, they will be moved down to prevent overlapping.

Can Shrink

Type: Boolean

Sets whether the control's height can decrease if the contents do not completely fill the control at runtime.

If there are other controls below the current control, they will be moved up to remove the unused space.

Rtf Expression

Type: String

Can be configured using the Expressions panel.

Sets the text of the control using RTF codes. Text can be manually entered in the property or field data can be added using the Expression Editor.

When the Rtf property is bound to a data field, the content is implemented with all text formatting from the data source. Changes applied to the text formatting at the control level aren't applied.

Html Expression

Type: String

Can be edited in the Expressions panel.

Sets the text of the control using HTML content. This property can only be populated using content from a data source. You cannot manually enter HTML content.

Behavior

Anchor Vertically

Sets the location of the control in relation to the parent container. When the parent container changes size, the control may move or resize to maintain its position.

The options for vertically anchoring include:

  • None: The control's size and location are not affected when the container size changes.
  • Top: The distance between the top of the control and the top of the container remains fixed when the container size changes.
  • Bottom: The distance between the bottom of the control and the bottom of the container remains fixed when the container size changes.
  • Both: The distance from the top and bottom of the control from the top and bottom of the container remains fixed when the container size changes. This means that control is resized to maintain these fixed distances.

Anchor Horizontally

Sets the location of the control in relation to the parent container. When the parent container changes size, the control may move or resize to maintain its position.

The options for horizontally anchoring include:

  • None: When the parent container changes size, the control's size and location are not affected when the container size changes.
  • Left: The distance between the left edge of the control and the left side of the container remains fixed when the container size changes.
  • Right: The distance between the right edge of the control and the right side of the container remains fixed when the container size changes.
  • Both: The distance from the left and right edges of the control from the left and right sides of the container remains fixed when the container size changes. This means that control is resized to maintain these fixed distances.

Can Grow

Type: Boolean

Sets whether the control's height can grow to display the contents at runtime.

Enabled by default.

If there are other controls below the selected control, they will be moved down to prevent overlapping.

Can Shrink

Type: Boolean

Sets whether the control's height can decrease if the contents do not completely fill the control at runtime.

If there are other controls below the current control, they will be moved up to remove the unused space.

Process Duplicates Mode

Sets how print controls with duplicate records should be processed. The data type that is processed must be set in the Process Duplicates Target property.

Methods for processing duplicate data include:

  • Leave: The duplicate control is always printed.
  • Merge: The identical data values are merged into a single column.
  • Suppress: A blank space is printed in place of the duplicate data.
  • Suppress and Shrink: The control that contains duplicate data is not printed.
  • This setting has no effect on intersecting controls or in vertical bands.

If there are no controls in a band after duplicates are removed, VertiGIS Studio Reporting does not print the band.

Process Duplicates Target

Sets what data is processed by the Process Duplicates Mode property.

Options include:

  • Value: The value of the control.
  • Tag: The data in the control's Tag property.

For the Rich Text control, the Rtf Expression property or HTML Expression property is used to assign a value to the Value property, depending on which one has been configured.

Process Null Values

Specifies how a print item containing a null value should be processed.

Methods of processing the null values include:

  • Leave: The print item is always printed.
  • Suppress: A blank space is printed in place of the null data.
  • Suppress and Shrink: The print item that contains null data is not printed.
  • This setting has no effect on intersecting controls or in vertical bands.

If there are no controls in a band after duplicates are removed, VertiGIS Studio Printing does not print the band.

Data

Null Value Text

Sets the location of the control in relation to the parent container. When the parent container changes size, the control may move or resize to maintain its position.

The options for vertically anchoring include:

  • None: The control's size and location are not affected when the container size changes.
  • Top: The distance between the top of the control and the top of the container remains fixed when the container size changes.
  • Bottom: The distance between the bottom of the control and the bottom of the container remains fixed when the container size changes.
  • Both: The distance from the top and bottom of the control from the top and bottom of the container remains fixed when the container size changes. This means that control is resized to maintain these fixed distances.

Load File

Loads RTF or HTML content into the control from a file.

Supports .rtf, docx, .txt, .htm, or .html file types.

Printing

Right to Left

Specifies the layout of the content within a print item.

The options include:

  • Inherit: The item inherits the printing configuration set at the parent level. This is the default.
  • Yes: The content is aligned to the right.
  • No: The content is aligned to the left.

Related Tutorials

Refer to the following resources for additional help on implementing this control: