List Contents Editor

Use the List Contents Editor dialog box to enter and edit a list of options displayed in a List box or Combo box on a form.

To display this dialog box, select a ListBox or ComboBox object on a form and click the ListContents property from the Property window for the selected object.

The dialog box allows you to create a list of selectable options, which are displayed at design time and runtime, and possible values that the selection returns.

Runtime created contents

List name − This field specifies the name of the list that is created at runtime by using the SENDLIST logic commands. The format of the name of the list object must be one of the following:

ispec.attribute (LBX; in previous versions of Developer)

*.attribute (LBX;* in previous versions of Developer)

file name (specifies the file name that contains the list items).

Object name from host − This field specifies the object name that is sent to the form by the host application program at runtime.

Item displayed in list − This field specifies which column from the data file is displayed in the list.

Value sent to host − This field specifies which column in the data file is sent to the host when you select the associated list item at runtime

Start line − This field specifies the number of the first displayable line in the file. This field applies only to List box controls.

Fixed contents

Text − Specifies the literal string displayed for an option within this box and allows you to edit existing option texts.

Value − Specifies the value returned when an option is selected and allows you to edit existing option values.

Insert − Inserts a new blank line in the list box after the line currently highlighted.

List − Displays the options that this list includes currently. To modify an existing option, select the option in the list, and then edit the values in the Text and Value fields.

Up and Down Arrows − Changes the order in which Options appear in the List box or Combo box.

Delete − Removes an Option from the List box or Combo box.

To add properties in the dialog, perform the following:

  1. Enter the literal string that you want to display in the Text field.

  2. Enter a value in the Value field.

  3. Click Insert to add to the list.

Note: The data for static list boxes is stored in a data file named <RuntimeDatabaseName>_<DeployedApplicationName>_listbox.dat in the ..\NGEN\DATA\Private folder, which is created at the time of installation of Developer. This file is created whenever you run a report or execute logic by using the SendListStatic command. You might want to backup this file periodically.