Pop-up Menus (Common Desktop Environment: Style Guide and Certification Checklist)

Common Desktop Environment: Style Guide and Certification Checklist

Pop-up Menus

Note -

These requirements apply only in a left-to-right language environment in an English-language locale. You must make the appropriate changes for other locales.

Pop-up menus provide access to frequently used functions and should be used pervasively throughout the Common Desktop Environment desktop environment. A pop-up menu may contain a collection of options that appear in different menus available from the menu bar. For example, it may contain items from both the File and Edit menus.

Recommended	by:	Your application should provide a pop-up menu for any element that is selectable within its data pane.
Recommended	bx:	If your application provides functions that apply to a data pane and not any specific element therein, then a pop-up menu is provided that contains the frequently used data pane functions and is accessible by pressing BMenu when the mouse pointer is over the background of the pane or a nonselectable element within the pane.
Recommended	cb:	The functions accessible from within your application's pop-up menus are also accessible from buttons displayed within the window or menus accessed through the menu bar.
Recommended	ca:	Every pop-up menu in your application has a title that indicates the function the menu performs or the element on which it operates.
Optional	cd:	Choices within your pop-up menus are organized in the following manner: <choices that manage the object such as Open, Save, and Properties> ----------- separator ---------------- <standard edit menu choices such as Cut, Copy and Paste> ----------- separator ---------------- <other choices>
Optional	6-11:	If your application uses any of the common pop-up menu actions, the actions function according to the following specifications. See item for supplemental guidelines. Properties Displays a properties dialog box that the user can use to set the properties of the component. Undo Reverses the last executed action. Primary Move Moves the contents of the primary selection to the component. This action is available only in editable components. Primary Copy Copies the contents of the primary selection to the component. This action is available only in editable components. Primary Link Places a link to the primary selection in the component. This action is available only in editable components. Cut Cuts elements to the clipboard. If the menu is popped up in a selection, cuts the entire selection to the clipboard. Copy Copies elements to the clipboard. If the menu is popped up in a selection, copies the entire selection to the clipboard. Copy Link Copies a link of elements to the clipboard. If the menu is popped up in a selection, copies a link to the entire selection to the clipboard. Paste Pastes the contents of the clipboard to the component. This action is available only in editable components. Paste Link Pastes a link of the contents of the clipboard to the component. This action is available only in editable components. Clear Removes a selected portion of data from the client area without copying it to the clipboard. If the menu is popped up in a selection, deletes the selection. Delete Removes a selected portion of data from the client area without copying it to the clipboard. If the menu is popped up in a selection, deletes the selection.
		Select All Sets the primary selection to be all of the elements in the collection with the pop-up menu. Deselect All Deselects the current selection in the collection with the pop-up menu. Select Pasted Sets the primary selection to be the last element or elements pasted into the collection with the pop-up menu. Reselect Sets the primary selection to be the last selected element or elements in the component with the pop-up menu. This action is available only in components that do not support persistent selections and only when the current selection is empty. Promote Promotes the current selection to the primary selection. It is available only in components that support persistent selections.
Recommended	cc:	Pop-up menus for selectable objects contain the following set of choices, with the specified functionality, when the actions are actually supported by your application. These guidelines supplement item . Move To... Allows the user to move the selected objects into a folder. A file selection dialog box is displayed allowing the user to select the desired folder. Copy To... Allows the user to copy the selected objects into a folder. A file selection dialog box is displayed allowing the user to select the desired folder. Put in Workspace Allows the user to put a link for the selected objects onto the Common Desktop Environment desktop in the current workspace. Delete Deletes the selected object. A confirmation is displayed to the user before actually removing the object. Help... Displays a help window pertaining to objects of the type selected.
Required	6-12:	When a pop-up menu is popped up in the context of a selection, any action that acts on elements acts on the entire selection. In the context of a selection, pop-up menu actions affect the entire selection.