ComboBox Object

Here are the object's settings as they appear on the "double-click" Properties dialog.

There are three tabs on the Properties dialog:

Settings

Attributes

Script

Settings Tab

Object

ComboBox items:

The items that are contained in the combobox.

The list consists of a number of items, each one with two parts: item text, which is the visible part that will appear in the combobox, 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 list by clicking on one of the fields and entering the desired text. You can manipulate the list using the buttons at the bottom of the dialog. The Insert Row button can be used to insert an item into the list, essentially inserting a new "row." The remove, up, and down buttons allow you to remove or move items in the list. The ascending and descending buttons can be used to sort the list in ascending or descending order.

Style

Dropdown list

Make the combobox selection read-only. (The selected text cannot be edited.)

Dropdown edit

Make the combobox selection editable. (The selected text can be edited.)

Options

Sort

Sort the combobox items alphabetically at runtime. If this option is unchecked, combobox items will be displayed in the order they appear at design time or added at runtime.

Lines to display in dropdown

The maximum number of lines to display in the combobox dropdown. The dropdown will only expand to the number of current entries up to this maximum. This value must be a number between 0 and 100 (inclusive).

Font ...

The font that you want to use for the text. Click the Select Font button to open the Font dialog where you can edit all of the font settings.

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

Special

Background:

The background color to use for the object.

Tip: You can click the select button to bring up a color chooser. 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.

Text:

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

Read order:

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.

Attributes Tab

Identification

Object name:

The name that is used to identify this object.

State

Enabled

Enable the object so it responds to user interaction. When an object is disabled, it will not respond to any mouse overs or clicks and will not perform any actions until it is enabled.

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

Visible

Set the object's initial visibility (whether it's visible when the page or dialog is displayed).

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

Auto-Resize

Left

If checked, the left side of the object will move when the application is resized. If unchecked, the left side of the object will not move.

Right

If checked, the right side of the object will move when the application is resized. If unchecked, the right side of the object will not move.

Top

If checked, the top of the object will move when the application is resized. If unchecked, the top of the object will not move.

Bottom

If checked, the bottom of the object will move when the application is resized. If unchecked, the bottom of the object will not move.

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.

Note: The height of a combobox object is determined by the font size, and cannot be set explicitly.

Restore Original

Set's the object's size back to the original values.

Feedback

Tooltip:

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 "&&&".

Spelling

Check the spelling of the tooltip text.

Cursor:

Note: This option is not available for combobox objects.

Script Tab

You can use the script editor on this tab to edit the script of actions that will be performed on each of this object's events.

This object supports the following events:

On Select

Fires when the combobox selection changes. The following event variable is automatically set whenever this event is triggered:

e_Selection:

(number) The index of the comboxbox item that is being selected. (The first item in the list has an index of 1.)

On Key

Fires whenever the combobox has focus and the user presses a key. The following event variables are automatically set whenever this event is triggered:

e_Key:

(number) The ASCII code of the key that was pressed.

e_Modifiers:

(table) A table containing three boolean values that describe which modifier keys were held down while the key was pressed. A modifier key is a key that can be held down while another key is pressed, to "modify" it. There are three true/false values in the table, one for each type of modifier key on the keyboard: shift, ctrl, and alt. You can access these values as e_Modifiers.shift, e_Modifiers.ctrl, and e_Modifiers.alt.

On Focus

Fires when the combobox receives input focus.