Visual InterDev

General Tab (Listbox Properties Dialog Box)

See Also      Tasks

Sets general options for the Listbox design-time control.

Options

Name

Type a name for the Listbox control. The name is required and must be unique to the page. Sets the id property property for the control.

Scripting Platform

Displays the platform (Server or Client) of the recordset selected for this control, or allows you to select a platform or use the page's default platform setting (Inherit from page) if you haven't selected a recordset. Sets the DTCScriptingPlatform property for the control.

After you set a recordset, the Scripting Platform property is read-only for the control. To change the platform, select a different recordset.

Style

Select Dropdown to create a drop-down list box or ListBox to create a list box that displays all the list selections directly on the page. Sets the ControlStyle property for the control.

Lines

Select the number of lines you want to display in the list box. This selection is disabled if you select Dropdown in the Style box. Sets the Lines property for the control.

Enabled

Clear this option to create the list box as text only. When a disabled list box is displayed in the browser, the user can't change its value or make any selections from the list. Sets the Enabled property for the control.

Visible

Clear this option to create the list box as a hidden form element. You might do this, for example, if you want to display the list box at run time only under certain conditions. Sets the Visible property for the control.

Data

Recordset

Choose the name of a Recordset design-time control on the page. Select the recordset with the data connection to the database you want to for the Listbox control. Sets the Recordset property for the control.

Field

Choose the name of the field whose data you want to display in the list box. Sets the DataField property for the control.

When you set a Bound column for a Recordset type of list box on the Lookup tab of the Listbox properties dialog box, the value of the Bound column field is written to this field when you select an item from the list.

Similarly, if you set a Static list type of list box on the Lookup tab, the value set in the Bound value column is written to this field when you select an item from the list.