ListBox Object Properties

When you want user to choose options from a list, add a List box to your form. Only one choice can be made from the list at runtime.

Property

Function

Id

Read-only. By default, automatically generated. Id="ListBox1" for the first inserted ListBox, Id="ListBox2" for the second, and so on.

Name

Read-only. The value of this property is set to Static control.

BackgroundColor

Specifies a background color for the object. Select a color from one of the tabs in the drop-down list. Note that you can specify a custom color. If you change this value, you can restore the default value specified for the parent object by right-clicking the property and clicking Reset on the context menu.

BorderStyle

Specifies a style to control the border of the container that surrounds the object. Options available for List Box control are None and Fixed3D.

Note: The appearance of a List Box is always Fixed3D, regardless of whether the None or Fixed3D options are selected.

Client generators such as Component Enabler and Winforms interpret the BorderStyle property set here in the Property window and generate the Graphical User Interface accordingly.

ControlType

Specifies ListBox as the type of object added to the form. To change the ControlType, choose from the list of available types.

Font

Specifies font attributes that are applied directly to the text appearing in the object. If you change this value, you can restore the default value specified for the parent object by right-clicking the property and clicking Reset on the context menu.

ForegroundColor

Specifies a foreground color for the object. Select a color from one of the tabs in the drop-down list. Note that you can specify a custom color. If you change this value, you can restore to the default value specified for the parent object by right-clicking the property and clicking Reset on the context menu.

ListContents

Opens the List Contents Editor to specify settings for the List Box. Can also be specified for a Combo Box.

Location

Specifies the point in pixels that represents the upper-left corner of the object relative to the upper-left corner of its container as an X and Y location.

ScrollBars

Specifies whether the ListBox should have scroll bars or not. Options are No (default) and Horizontal.

Size

Specifies the size of the object representing the height and width in pixels.

TabIndex

Specifies the index that defines the tab order for the object.

ToolTip

Specifies an optional tooltip to appear when the user at runtime hovers the mouse over a control in Winforms. To view the tooltip in the Presentation Client, the user has to hover over the control and press the F1 key. This tooltip is visible only at runtime.