The Manage Related Items dialog box provides the user with an interface to display and maintain related items for a specified relationship. Examples are Manage Related Items for Form, Manage Related Items for Column Sets, and Manage Menus.
The following diagram shows a typical Manage Related Items dialog box (for the SPFDBFile form, in this example).
|
1 |
Parent item (shown in title form) |
|
2 |
Related Items pane (with configurable columns) |
|
3 |
Library pane |
The left pane represents a list of related items (in this example, form sections), the properties on the objects, and the relationships that can be edited directly in the list view window. These updates are saved to the database when you click OK and ignored when you click Cancel.
The right pane displays a library that contains a set of valid items that can be related to the object (in the example in the diagram, form sections). The library allows the user to create new items, delete items, and relate items to the original object.
The library control can be turned on or off via the method arguments. To relate an
item, select it in the Library pane, and click the Relate Selected Item 
button. The item selected will appear in the list on the left, and you can click
each cell to edit or add values.
You can change the positions of the two panes on this dialog box. Click the Switch Orientation 
button to switch to portrait orientation. In portrait orientation, the Related Items
pane appears at the top of the dialog box and the Library pane appears at the bottom.
In portrait orientation, click the Relate Selected Item 
button on the left side of the Library pane to add items to the Related Items pane
and relate them to the original object. Click the Switch Orientation button again to return to landscape orientation.
The following example shows the dialog box in portrait orientation.
Related Items (left or upper pane) buttons
|
|
Move selected item up. |
|
|
Move selected item down. |
|
|
Click to remove the selected item from the form. The relationship between the item and the definition is removed, but the item remains in the database. |
Library (right or lower pane) buttons
|
|
Create - Opens the dialog box for creating a new object. On completion, the object is immediately saved to the database. |
|
|
Update - Opens the Update dialog box for the item selected in the library list. On completion, the object is immediately saved to the database. |
|
|
Deletes the selected library item. On completion, the object is immediately removed from the database. |
|
|
Find - Enter an item name (or part of the name plus wildcards*) in the Find box, and click Find. The results are displayed in the Library pane. |
|
|
Clear - Clears the Library pane. |
|
|
Advanced filtering - Opens a dialog to enable property filtering on the library properties. |
|
|
Relate item selected in the Library pane to the parent item. The related item will also be displayed in the Related Items pane. |
Dialog box manipulation buttons
|
|
Switch orientation - Changes the orientation of the Library pane and Related Items pane from landscape (the Related Items pane is on the left, and the Library pane is on the right) to portrait (the Related Items pane is on the top of the dialog box, and the Library pane is on the bottom). |
For more information about the ManageRelatedItems API that is used by method to open these controls, see ManageRelatedItems API argument summary.