[ Previous |
Motif and CDE 2.1 Style Guide Reference
Push Button (Predefined)
Push buttons can provide predefined functions. The predefined push buttons
are Apply, Cancel, Close, Continue, Help, More, No, OK, Pause, Reset, Reset To
Default, Resume, Retry, Save As Default, Stop, Undo, and Yes.
When to Use
RequiredUse a push button with the predefined label when you provide the function
defined as follows:
ApplyAn action choice that appears in a window and makes the changes indicated
in the window without closing it.
CancelAn action choice that removes a secondary window without applying any
changes made in that window.
CloseAn action choice that removes a window and all of the windows associated
with it from a screen.
ContinueAn action choice that resumes a task that has been interrupted by the
application operating environment when the user can proceed as originally
HelpAn action choice used on push buttons in secondary windows to provide help
specific to that window.
A cascading choice that appears as a menu-bar item and provides access to
other menu items that contain information related to the use of the
MoreAn action choice that displays additional controls in a separate window.
An action choice that expands the current dialog to show more value choices
and replaces itself with the current dialog.
NoAn action choice that indicates a negative response to a question
presented in a message.
OKAn action choice that accepts the information in a window and closes it.
If the window contains changed information, those changes are applied before
the window is closed.
PauseAn action choice that temporarily suspends a task without ending it.
RESETAn action choice that resets the values displayed in a dialog or property
window to the values they had when the window became displayed or when the
values were last saved as defaults, whichever is most recent.
Reset To DefaultAn action choice that resets the values displayed in a dialog or property
window to the values they had when default values were last saved.
ResumeAn action choice that resumes a task that the user paused.
RetryAn action choice that attempts to complete an interrupted task.
Save As DefaultAn action choice that saves the values displayed in a dialog or property
window as defaults to be used when the same (or similar) window is
subsequently displayed to the same user by the application.
StopAn action choice that ends a task and removes the message window.
UndoAn action choice that undoes the effect of the last Apply.
YesAn action choice that indicates a positive response to a question
presented in a message by an application or the system.
RequiredIf you provide the Cancel and Help push buttons, place them to the right
of all other push buttons. For information on bidirectional and vertical
language support, see Chapter
RequiredDo not use both a Close push button and a Cancel push button in the same
RequiredProvide a Resume push button whenever you provide a Pause push button.
RequiredWhen the user makes changes in a dialog or property window and then
activates Reset before committing them, return the application to the state
that it was in before the user made the changes. Do not reset changes that
have been previously committed, for example when the user has selected Apply
RequiredWhen the user selects Reset, restore the settings of values only in the
window where Reset was activated.
RequiredProvide a Reset push button whenever you provide an Apply or OK push
RecommendedWhen Apply and Undo are both provided as push buttons in a window, unless
the Undo label is augmented to indicate otherwise, make Undo undo the effects
of the last Apply. If you support only a single-level Undo, then after the
user selects Undo, restore the changes undone if the user selects Undo again.
RecommendedProvide an Undo push button whenever you provide an Apply push button.
RecommendedProvide a Save As Default push button if you expect the user to save the
values just set.
RecommendedWhen the user selects the Help push button, provide access to help
information that directly relates to the user's current situation. For
example, when the user encounters an error message, provide easy access to
information that will assist the user in solving the problem that caused the
RecommendedWhen the user selects the Help push button, display help information in a
separate primary window.
Essential Related Topics
For more information, see the Push Button (Control) reference page.
Supplemental Related Topics
For more information, see the Action Message, Close (Choice), Default
Action, Help Menu, and Primary Window reference pages.
[ Previous |