List view control

A list view control displays the records 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.

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, he 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 associated with this control are displayed in the control pop-up menu in the Rational® ClearQuest® Client. To run one of these hooks, users must right-click the control and select the name of the hook.