Tree 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.

Items

The items that are contained in the tree. Click the edit button to open the Tree Items dialog where you can create or modify your list.

A tree consists of a number of items, each one with two parts: item text, which is the visible part that will appear in the tree, and item data, which is an invisible part that is associated with that item. You can use the item data to store any information that you want to associate with the item text, such as a file path or page name.

Items can be added to the tree by clicking add button and entering the desired text. You can manipulate structure of the tree using the buttons at the bottom of the dialog.

Options

Checkboxes

Show checkboxes next to each item in the tree.

HasLines

Include lines linking the items in the tree.

LinesAtRoot

Includes lines at the root level of the tree linking sub items.

HasButtons

Include expand/collapse buttons by each item with child elements.

EditLabels

Allow the items in the tree to be edited or renamed, similar to how files and folders are renamed in windows.

AlwaysShowSelection

Causes a selected item to remain selected when the tree-view control loses focus.

Font

The font that you want to use for the text.

Tip: You can set the default font for this object type by configuring its settings on the Objects tab in Edit > Preferences.

FontFamily

The font family that you want to use.

FontSize

The font size, in points.

FontBold

Make the text bolded.

FontItalic

Make the text appear in italics.

BackgroundColor

The background color to use 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.

TextColor

The text color to use for the items in this object. You can click the select button to bring up a color chooser.

BorderMode

The style of border to display around the object.

None

Don't display any border around the object.

Flat

Display a thin black 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.

UseImageList

True if the specified image list file should be used in the tree object, false if it should not be.

ImageList

A bitmap image (maximum 32bit supported) that contains 16x16 icons to be used by the Tree object as icons for each tree item.

Note: The image used as the image list must be a bitmap image (.bmp).

The following example illustrates a proper image list:

The picture above includes three 16x16 icons. The orange icon (left-most) has an index of 0. The purple icon (middle) has an index of 1. The circle icon (right-most) has an index of 2.

Note: To specify which icon each tree item will display, specify the Image index in each item's properties.

ImageListTransparentColor

The color that will be transparent in the image list. Click the select button to bring up a color chooser. The color that you click on will be used to represent transparency in the image list.

 

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.

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 Tree.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 Tree.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.

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 Select

The actions that will be performed when the user selects or deselects items in the tree. Click the edit button to open the action editor.

On Double-Click

The actions that will be performed when the user double-clicks an item in the tree. Click the edit button to open the script editor.

On Key

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

On Focus

The actions that will be performed whenever the tree 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 EditLabel

The actions that will be performed whenever an item's label is changed in the tree object. Click the edit button to open the action editor.

On Check

The actions that will be performed whenever an item is checked/unchecked in the tree object. Click the edit button to open the action editor.

On Expanded

The actions that will be performed whenever an item is expanded/collapsed in the tree object. Click the edit button to open the action editor.