Progress
AppBuilder
Developer’s Guide


Configuring a SmartSelect Instance

The SmartSelect has a relatively complex Instance Properties dialog box:

Data Source

This section identifies the SmartDataObject that will feed the SmartSelect object. You cannot enter the filename of the SmartDataObject directly; AppBuilder fills in this field as part of creating the SmartLinks, once you place the SmartDataObject in the Viewer workspace.

You can subset the data that the SmartSelect displays. Type a subsetting expression—for example:

Credit–Limit > 10000

into the Filter field. The SmartSelect will then display only the subset of items that conform to that restriction.

Data

This section describes the field being replaced, and the identifying characteristics of its replacement:

Properties

This section presents three important behavioral properties:

Optional

This check box is normally cleared. Setting this box means that the associated field need not have a value.

You can specify the text that represents that nonvalue; the default is “<none>”. Note that this text does not necessarily appear at the top of your list of choices. If you wish it to appear as the first item in the list, you must either explicitly make it the first item in the source (for unsorted lists) or begin with some character, such as the angle bracket (<), that the sort operation will move to the top of the list.

Visualization

This section allows you to specify how the SmartSelect list will represent itself at run time. The choices are:

Displayed Field Attributes

Specify the characteristics of the field you display as a prompt to the user:

Geometry

Displays the origin and size of the SmartSelect representation in character units. You can set these values here, or in pixel units in the Advanced Properties dialog box.


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095