RichText Object

Here are the object's settings as they appear in the properties pane:

Object

Name

The name that is used to identify this object.

Text

The Rich Text (RTF format) you want to display in the RichText object.

Options

VerticalScrollbar

Include a vertical scroll bar for the text. Choose from:

True

Include a vertical scroll bar for the text if the amount of text to be displayed exceeds the vertical visible area.

False

Don't include a vertical scroll bar. Any text exceeding the visible area will be cut off.

HorizontalScrollbar

Include a horizontal scroll bar for the text. Choose from:

True

Include a horizontal scroll bar for the text if the amount of text to be displayed exceeds the horizontal visible area.

False

Don't include a horizontal scroll bar. Any text exceeding the horizontal area will wrap to the next line.

AutoDetectURL

Automatically detect URLs in the object text. Choose from:

True

Automatically detect URLs in the object text. This means URLs will be shown as hyperlinks and will fire the richtext object's On Link event when they are clicked on.

False

Don't automatically detect URLs in the object text, and don't fire the On Link event.

Special

BorderMode

The type of border to display around the object. Choose from:

None

Don't display any border around the object.

Sunken

The object will have a "sunken" appearance on the page or dialog.

ReadOrder

The order the text will display when typed into the object. Choose from:

Standard

Display the text normally, from left to right.

Right to Left

If the shell language is Hebrew, Arabic, or another language that supports reading-order alignment, the text is displayed using right-to-left reading-order properties. For other languages, this style is ignored.

Transparent

Whether to make the background of the object transparent. Choose from:

True

Make the background of the object transparent.

False

Use a solid BackgroundColor for the background of the object.

BackgroundColor

The background color for the object. You can click the select button to bring up a color chooser.

Tip: Clicking the "More Colors..." button on the color menu allows you to choose either a standard color/custom color, or use the eyedropper to pick a color from somewhere within the AutoPlay application window.

ReadOnly

Whether to make the text in the object read-only. Choose from:

True

Make the text in the object read-only so the user cannot type into it. This means the user can copy the text, but cannot modify it.

False

Don't make the object read-only. This means the user can copy or modify the text.

ShowContextMenu

Show a right-click context menu in the object. Choose from:

True

Show a right-click context menu in the object with features such as "Cut," "Copy" and "Paste."

False

Don't show a right-click context menu in the object.

Attributes

TooltipText

A short string of text that will appear after the mouse hovers over this object for a moment.

Tip: You can choose from several tooltip styles for all tooltips in your project, Standard, Balloon and Extended. This setting can be found on the Appearance tab of the Project > Settings.

Tip: If you want a newline in your tooltip text, use "\r\n". For example, for an Extended tooltip, "My First Line\r\nMy Second Line|My Title". Newlines are not supported in the Title text for Balloon or Extended styles.

Tip: If you want a "&" character in the text, you must enter "&&&".

Enabled

Enable the object so it responds to user interaction. Choose from:

True

The object will respond to mouse overs and clicks and perform any actions assigned to its events.

False

The object will not respond to any mouse overs or clicks and will not perform any actions until it is enabled.

Note: You can use the RichText.SetEnabled action to enable this object.

Visible

Set the object's initial visibility. Choose from:

True

The object will be visible when the page or dialog is displayed.

False

The object will be invisible when the page or dialog is displayed.

Note: You can use the RichText.SetVisible action to make the object visible or invisible at run time.

Position

Left

The distance in pixels from the left edge of the object to the left edge of the page or dialog.

Tip: You can also change the position of an object by dragging it or using the arrow keys.

Top

The distance in pixels from the top edge of the object to the top edge of the page or dialog.

Width

The width of the object in pixels.

Tip: You can also resize an object by dragging one of the resize handles on its bounding box.

Height

The height of the object in pixels.

Auto-Resize

ResizeLeft

Whether the left side of the object will move when resized. Choose from:

True

The left side of the object will move when the application is resized.

False

Don't move the left side of the object when the application is resized.

ResizeRight

Whether the right side of the object will move when resized. Choose from:

True

The right side of the object will move when the application is resized.

False

Don't move the right side of the object when the application is resized.

ResizeTop

Whether the top of the object will move when resized. Choose from:

True

The top of the object will move when the application is resized.

False

Don't move the top of the object when the application is resized.

ResizeBottom

Whether the bottom of the object will move when resized. Choose from:

True

The bottom of the object will move when the application is resized.

False

Don't move the bottom of the object when the application is resized.

Actions

On Key

The actions that will be performed whenever the richtext object has focus and the user presses a key. Click the edit button to open the script editor.

On Focus

The actions that will be performed whenever the richtext object is given focus. For example, it will be given focus if the user clicks inside the object. Click the edit button to open the script editor.

On Link

The actions that will be performed when the user clicks on a link in the richtext object. Click the edit button to open the script editor.

Note: To use this event, you must have the Auto-detect URL feature enabled.

On Selection Changed

The actions that will be performed when the selection changes in the richtext object. Click the edit button to open the script editor.