List view control

A list view control displays the records that are associated with a field whose type is REFERENCE LIST. One of the primary uses of this control is to display the parent of a parent/child relationship. If you want to use a list view to link related records, use the parent/child control instead.

Note: To improve performance when opening records, you can defer the loading of reference list fields until the user requests the associated data by clicking a button in the control. For information on controlling deferred reference list loading, see technote 1976572.
Note: To enable the List View Query feature to run user-defined queries on the list view control, see technote 1990415.

To determine which fields of a record are displayed in a list view control, add columns to the list view. Right-click in the header bar and click Add Column. Each column refers to a particular field of the referenced records. Right-click a column and click Properties to edit the field name. You can change the name of a field at any time, however, you cannot change the column name.

Use a list view control to display a back reference field in your form. The back reference field is a read-only REFERENCE LIST field and is used to store the parent record information in a parent/child relationship.

The property sheet for a list view control has three pages: General, Extended, and Context Menu Hooks.

General page

The following table lists the properties of the General page.

Property
Description
Field Name
Select the field to associate with the control.
Label
Enter a label for the control. By default, the label is the name of the selected field.
X
The horizontal starting point of the control in pixels.
Y
The vertical starting point of the control in pixels.
Width
The width of the control in pixels.
Height
The height of the control in pixels.

Extended page

The Extended page contains one text box for entering the ID of the list view. This ID must be unique among any other list view controls in that page. You need this ID for the push buttons that you associate with the list view.

Context Menu Hooks page

The Context Menu Hooks page displays the list of available record hooks and the hooks that are currently associated with this control. To associate a hook with the control, select the hook in the Available column and click Add. To dissociate a hook, select the hook in the Selected column and click Remove. Hooks that are associated with this control are displayed in the control pop-up menu in the HCL Compass Client. To run one of these hooks, users must right-click the control and select the name of the hook.