[ Previous |
Motif and CDE 2.1 Style Guide Reference
Find (Choice and Dialog)
The Find choice can be one of the following:
A dialog choice that initiates a search for objects or data associated
with the contents of the current window
A dialog that allows the user to specify the criteria to be used for the
An action choice within the Find dialog
Figure 27. Find Choice and Dialog.
When to Use
RequiredProvide a Find choice in the Edit menu to search for elements that match
specified criteria. These elements may either be:
Within the view itself
Within objects that are represented in the view
In other objects, with the data in the view used, in part, to identify the
other objects and/or the search criteria
RequiredWhen Find is chosen, display a Find dialog window that allows a user to
specify the parameters of the search. For example, when using the Find choice
to search for text, allow a user to specify the text to be found, the
direction of the search, sensitivity to text capitalization, and similar
RequiredIf Find is used to find one match at a time, and more than one match meets
the criteria, keep the Find dialog displayed.
RequiredWhen the user specifies new criteria (and matches are to be found one at a
time) and chooses the Find push button, find the first match and display it in
RequiredWhen the Find dialog remains displayed after the user chooses Find within
it, find the next match when the user chooses Find again.
RecommendedIf you want to allow every match found to be replaced, then use a Replace
RecommendedIf Find or Replace is used to find matches only within objects that are
represented in the view, place the choice on the Selected menu.
RecommendedIf the find operation is used to search for a single element, when the
next match is found, move the active cursor to the matching element.
RecommendedIf the find operation is used to search for a combination or sequence of
elements (such as a word made up of text characters), select the next matching
combination or sequence found.
RecommendedIf Find is used to search for an element (or elements) outside of the
current window, open a window to view the matching element within the object
in which the next match is found. Then remove the window in which the previous
match was found (unless it was the one from which the find operation was
RecommendedIf Find is used to search for an element (or elements) within objects
represented in the current window, move the cursor in the current window to
the object in which the next match is found. Also, open a window to view the
matching element within that object.
RecommendedAvoid changing the contents of a window as a result of a find operation,
except to scroll the next match into sight and to indicate that it matches the
RecommendedWhen Find is available in the Edit menu to search for elements within
objects represented in the current window, the semantics for Find (for
example, which objects it applies to) match those for choices in the Selected
RecommendedWhen Find is used to search for elements within the current window,
provide a choice within the Find dialog that indicates whether the search
should be restricted to the currently selected elements.
RecommendedIf Find is used to search for a combination or sequence of elements (such
as a word made up of text characters) within a single selection scope, and
discontiguous selections are supported in that scope, provide a choice within
the Find dialog that determines when the next matching combination or sequence
is found and selected, according to the following:
The current selection should first be deselected
The newly selected matching elements should be added to the current
RecommendedIf the find operation is used to find matches within a single selection
scope, include a choice within the Find dialog to determine whether to find
matches one at a time (the default) or find all the matches at once. If the
user chooses this option, Find selects all the matching elements (or
combinations or sequences of elements).
Essential Related Topics
For more information, see the Edit Menu and View Menu reference pages.
Supplemental Related Topics
For more information, see the Object and Selection reference pages.
[ Previous |