y 

n/a 

n 

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 

_ 

_ 

_ 

by: 

Your application should provide a pop-up menu for any element that is selectable within its data pane. 

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 

_ 

_ 

_ 

bz: 

When a pop-up menu is displayed over an unselected object, any action selected from the pop-up menu applies to that object only, and not to any other objects that might currently be selected. 

The preceding helps to protect the user from inadvertently applying an action to objects that the user may not realize are currently selected. Pressing the menu button invokes a pop-up menu pertinent to the object under the mouse cursor whether it is selected to not; if the object under the mouse cursor and other objects are selected, the pop-up menu is pertinent to the selected set. 

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. 

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. 

Because pop-up menus are hidden, they should only provide redundant access to functions available from more visible controls within the application's windows. 

Optional 

_ 

_ 

_ 

6-11: 

If your application uses any of the common pop-up menu actions, the actions function according to the following specifications.  

Optional 

_ 

_ 

_ 

Properties 

Displays a Properties dialog box that the user can use to set the properties of the component.  

Optional 

_ 

_ 

_ 

Undo 

Reverses the most recently executed action. 

Optional 

_ 

_ 

_ 

Primary Move 

Moves the contents of the primary selection to the component. This action is available only in editable components.  

Optional 

_ 

_ 

_ 

Primary Copy 

Copies the contents of the primary selection to the component. This action is available only in editable components.  

Optional 

_ 

_ 

_ 

Primary Link 

Places a link to the primary selection in the component. This action is available only in editable components. 

Optional 

_ 

_ 

_ 

Cut 

Cuts elements to the clipboard. If the menu is popped up in a selection, cuts the entire selection to the clipboard. 

Optional 

_ 

_ 

_ 

Copy 

Copies elements to the clipboard. If the menu is popped up in a selection, this action copies the entire selection to the clipboard. 

Optional 

_ 

_ 

_ 

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.  

Optional 

_ 

_ 

_ 

Paste 

Pastes the contents of the clipboard to the component. This action is available only in editable components.  

Optional 

_ 

_ 

_ 

Paste Link 

Pastes a link of the contents of the clipboard to the component. This action is available only in editable components.  

Optional 

_ 

_ 

_ 

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.  

Optional 

_ 

_ 

_ 

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. 

Optional 

_ 

_ 

_ 

Select All 

Sets the primary selection to be all of the elements in the collection with the pop-up menu.  

Optional 

_ 

_ 

_ 

Deselect All 

Deselects the current selection in the collection with the pop-up menu.  

Optional 

_ 

_ 

_ 

Select Pasted 

Sets the primary selection to be the last element or elements pasted into the collection with the pop-up menu.  

Optional 

_ 

_ 

_ 

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. 

Optional 

_ 

_ 

_ 

Promote 

Promotes the current selection to the primary selection. It is available only in components that support persistent selections. 

The use of pop-up menus with these common actions yields consistency across applications. 

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. 

Optional 

_ 

_ 

_ 

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. 

Optional 

_ 

_ 

_ 

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. 

Optional 

_ 

_ 

_ 

Put in Workspace 

Allows the user to put a link for the selected objects onto the Common Desktop Environment desktop in the current workspace. 

Optional 

_ 

_ 

_ 

Delete 

Deletes the selected object. A confirmation is displayed to the user before actually removing the object. 

Optional 

_ 

_ 

_ 

Properties ... 

Displays a dialog box indicating the current settings for attributes associated with the selected object. 

Optional 

_ 

_ 

_ 

Help ... 

Displays a help window pertaining to objects of the type selected. 

Optional 

_ 

_ 

_ 

cd: 

Choices within your pop-up menus are organized in the following manner: 

<choices that manage the object such as Open, Save, or Properties> 

----------- separator ---------------- 

<standard edit menu choices such as Cut, Copy, and Paste> 

----------- separator ---------------- 

<other choices> 

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.