pop-up-shortcut-menu

Arguments: window

Pops up a menu for window if the shortcut-commands method for window returns a list of menu-items. Does nothing if shortcut-commands instead returns nil, which is the default case.

The default mouse-right-down methods for basic-pane and dialog-item call this function on the window that was clicked. (If a dialog-item is right-clicked, window will be the window of the dialog-item rather than the dialog-item itself.) The default virtual-key-down method for basic-pane calls this function as well when the "context menu key" is pressed (see vk-applications).

Compatibility note: in releases through 6.1, the default mouse-right-down methods called pop-up-shortcut-menu only in the IDE, and not in generated standalone applications. Now, as said above, mouse-right-down calls pop-up-shortcut-menu is both cases. This might change the default behavior of an application only if the application defined shortcut-commands methods.

This function creates (and later closes) a menu which is an instance of the class returned by the shortcut-menu-class method for window. By default, this is the shortcut-menu class, whose on-click function is default-menu-on-click. So in the default case, the value of each menu-item should be as described under default-menu-on-click. Alternately, a shortcut-menu-class method could be defined that uses a different on-click function.

Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.