List Box Screen

The List Box screen's properties dialog contains the following four tabs of properties you can set:

Settings

Instructions

Top:

The text you want to appear at the top of the screen, above the list box.

Bottom:

The text you want to appear at the bottom of the screen, below the list box.

List Box

Items:

The items you want to show in the list box. Each line in this area will be shown as one list box item.

Options

Enabled

Enable the list box so it responds to user interaction. When a list box is disabled, all of its items will appear greyed out and cannot be selected.

Visible

Set the initial visibility of the list box (whether it's visible when the screen is displayed).

Sorted

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

Multi select

Enable multiple list box items to be selected at one time.

Style

List Box

Use a standard list box style.

Checklist Box

Use a checklist box style. A checklist box is a standard list box combined with a check box for each item.

Language

Language:

The supported language you want to translate the screen text for. You can click the select button ( ) to select a different language currently supported in your setup.

Note: You can add additional language support from the Languages dialog which can be accessed by going to Project > Languages...

 

Tip: You can see how the screen will look at runtime by clicking the Preview button.

Attributes

The screen's attributes tab contains generic settings such as its design-time name, window title, banner style and text and various button settings. The details of this tab's contents are explained in the Screen Attributes topic.

 

Style

The Style tab is used to customize the screen's appearance beyond the global project theme.

Override project theme

Override the global project theme in order to customize the appearance of the current screen. These settings are the same as the Theme Properties dialog, except they only affect the current screen.

Note: Unchecking this option after changes have been made will restore the default theme settings. Any changes made to these settings will be lost.

Tip: If you are editing a screen and you have the Override project theme selected, you can right click on the screen preview and select "Save as Theme..." to save the created theme.

 

Actions

The Actions tab contains the action editor dialog where you can add actions or scripts to each event supported by the screen.

Note: Some events will already contain action script and should not be modified unless you want to customize the default behavior of the screen.

The List Box screen contains the following screen events:

Tip: You can use the On Ctrl Message event to detect and respond to user interaction. See the Advanced topic for the list of control IDs and string IDs that are available on this screen.

Tip: You can click on one of the event names above for a full description.