[ Previous | Next | Contents | Glossary | Home | Search ]
Motif and CDE 2.1 Style Guide Reference

Include (Choice and Dialog)

Reference

Description

Include is a dialog choice used either to determine which elements are displayed within a window or to identify the subset of elements to be displayed, added, or removed from a view.

When to Use

Recommended
Provide an Include choice in the View menu when it is useful to view subsets of elements contained within the view.

Required
When Include is chosen, display an Include dialog window that allows the user to specify a subset of elements to be displayed within the view.

Guidelines

Required
When an element is added to the data on which a view filtered by an include action is displayed, and the element matches the criteria for the view, display the element in the view.

Recommended
When the user specifies, in the Include dialog, the properties of a subset of the elements that can be viewed, allow the user to choose whether to:

  1. Replace the elements in the current view (for example, show the specified subset of all the elements instead)

  2. Restrict the current view (for example, show the specified subset of the currently viewed elements)

  3. Add elements to the view (for example, add the specified subset of all the elements to the view)

  4. Remove elements from the view (for example, remove the specified subset of the currently viewed elements from the view)

    5. Recommended
    In the window in which the results of the Include operation are displayed, provide a status area to list the criteria used to create the subset, as well as the number of elements displayed and the total number of elements from which they were chosen.

    Recommended
    Provide a choice within the Include dialog to allow the result of the Include operation to be shown in a separate window instead of in the current view.

    Essential Related Topics

    For more information, see the View and View Menu reference pages.

    Supplemental Related Topics

    For more information, see the Object and Selection reference pages.

    [ Previous | Next | Contents | Glossary | Home | Search ]